From a7b9fc0c86b4a625c3b8f580f6c4ec9503a65bd8 Mon Sep 17 00:00:00 2001 From: "pedemont%us.ibm.com" Date: Wed, 27 Sep 2006 15:11:28 +0000 Subject: [PATCH] Bug 305815 - Better organize Java interfaces. Implement getGREPathWithProperties(). r=bsmedberg, r=lbustelo. Not part of default build. This file was copied in CVS from the following location: mozilla/extensions/java/xpcom/interfaces/IAppFileLocProvider.java Original committer: pedemont%us.ibm.com Original revision: 1.1 Original date: 2005/10/28 01:59:03 --- .../mozilla/xpcom/IAppFileLocProvider.java | 92 +++++++++++++++++++ 1 file changed, 92 insertions(+) create mode 100644 extensions/java/xpcom/interfaces/org/mozilla/xpcom/IAppFileLocProvider.java diff --git a/extensions/java/xpcom/interfaces/org/mozilla/xpcom/IAppFileLocProvider.java b/extensions/java/xpcom/interfaces/org/mozilla/xpcom/IAppFileLocProvider.java new file mode 100644 index 000000000000..be13c1ba4a2e --- /dev/null +++ b/extensions/java/xpcom/interfaces/org/mozilla/xpcom/IAppFileLocProvider.java @@ -0,0 +1,92 @@ +/* ***** BEGIN LICENSE BLOCK ***** + * Version: MPL 1.1/GPL 2.0/LGPL 2.1 + * + * The contents of this file are subject to the Mozilla Public License Version + * 1.1 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + * http://www.mozilla.org/MPL/ + * + * Software distributed under the License is distributed on an "AS IS" basis, + * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License + * for the specific language governing rights and limitations under the + * License. + * + * The Original Code is Java XPCOM Bindings. + * + * The Initial Developer of the Original Code is + * IBM Corporation. + * Portions created by the Initial Developer are Copyright (C) 2004 + * IBM Corporation. All Rights Reserved. + * + * Contributor(s): + * Javier Pedemonte (jhpedemonte@gmail.com) + * + * Alternatively, the contents of this file may be used under the terms of + * either the GNU General Public License Version 2 or later (the "GPL"), or + * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"), + * in which case the provisions of the GPL or the LGPL are applicable instead + * of those above. If you wish to allow use of your version of this file only + * under the terms of either the GPL or the LGPL, and not to allow others to + * use your version of this file under the terms of the MPL, indicate your + * decision by deleting the provisions above and replace them with the notice + * and other provisions required by the GPL or the LGPL. If you do not delete + * the provisions above, a recipient may use your version of this file under + * the terms of any one of the MPL, the GPL or the LGPL. + * + * ***** END LICENSE BLOCK ***** */ + +package org.mozilla.xpcom; + +import java.io.*; + + +/** + * Used by XPCOM's Directory Service to get file locations. + *

+ * This interface is similar to nsIDirectoryServiceProvider and + * nsIDirectoryServiceProvider2, except that its methods use + * java.io.File instead of nsIFile. + *

+ * + * @see Mozilla#initEmbedding + * @see Mozilla#initXPCOM + * @see + * nsIDirectoryServiceProvider + * @see + * Directory Service property names + */ +public interface IAppFileLocProvider { + + /** + * Directory Service calls this when it gets the first request for + * a property or on every request if the property is not persistent. + * + * @param prop the symbolic name of the file + * @param persistent an array of length one used to supply the output value: + * + * + * @return the file represented by the property + */ + public File getFile(String prop, boolean[] persistent); + + /** + * Directory Service calls this when it gets a request for + * a property and the requested type is nsISimpleEnumerator. + * + * @param prop the symbolic name of the file list + * + * @return an array of file locations + */ + public File[] getFiles(String prop); + +} +