01: /*
02: * Licensed to the Apache Software Foundation (ASF) under one or more
03: * contributor license agreements. See the NOTICE file distributed with
04: * this work for additional information regarding copyright ownership.
05: * The ASF licenses this file to You under the Apache License, Version 2.0
06: * (the "License"); you may not use this file except in compliance with
07: * the License. You may obtain a copy of the License at
08: *
09: * http://www.apache.org/licenses/LICENSE-2.0
10: *
11: * Unless required by applicable law or agreed to in writing, software
12: * distributed under the License is distributed on an "AS IS" BASIS,
13: * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14: * See the License for the specific language governing permissions and
15: * limitations under the License.
16: */
17:
18: package javax.naming.spi;
19:
20: import java.util.Hashtable;
21: import javax.naming.Name;
22: import javax.naming.Context;
23: import javax.naming.directory.Attributes;
24:
25: /**
26: * An <code>DirObjectFactory</code> creates objects of a specified type.
27: * <code>DirObjectFactory</code> is a specific version of
28: * <code>ObjectFactory</code> for <code>DirectoryManager</code>.
29: *
30: * @see ObjectFactory
31: * @see DirectoryManager
32: */
33: public interface DirObjectFactory extends ObjectFactory {
34:
35: /**
36: * Similar to <code>ObjectFactory.getObjectInstance</code>, with an
37: * additional <code>attributes</code> parameter.
38: *
39: * @param o
40: * an object
41: * @param n
42: * a name
43: * @param c
44: * a context
45: * @param envmt
46: * a context environment
47: * @param a
48: * some attributes
49: * @return the created object
50: * @throws Exception
51: * if an exception occurs
52: * @see ObjectFactory#getObjectInstance(Object, Name, Context, Hashtable)
53: */
54: Object getObjectInstance(Object o, Name n, Context c,
55: Hashtable<?, ?> envmt, Attributes a) throws Exception;
56:
57: }
|