01: //
02: // This file was generated by the JavaTM Architecture for XML Binding(JAXB) Reference Implementation, v1.0.5-b16-fcs
03: // See <a href="http://java.sun.com/xml/jaxb">http://java.sun.com/xml/jaxb</a>
04: // Any modifications to this file will be lost upon recompilation of the source schema.
05: // Generated on: 2005.09.05 at 03:09:41 PM IST
06: //
07:
08: package com.sun.xml.wss.saml.internal.saml11.jaxb10.impl.runtime;
09:
10: import javax.xml.namespace.NamespaceContext;
11:
12: /**
13: * Maintains namespace<->prefix bindings.
14: *
15: * <p>
16: * This interface extends {@link NamespaceContext} and provides
17: * an additional functionality, which is necessary to declare
18: * namespaced attributes on elements. The added method is for
19: * self-consumption by the marshaller.
20: *
21: * This object is composed into a Serializer.
22: */
23: public interface NamespaceContext2 extends NamespaceContext {
24: /**
25: * Declares a new namespace binding within the current context.
26: *
27: * <p>
28: * The prefix is automatically assigned by MarshallingContext. If
29: * a given namespace URI is already declared, nothing happens.
30: *
31: * <p>
32: * It is <b>NOT</b> an error to declare the same namespace URI
33: * more than once.
34: *
35: * <p>
36: * For marshalling to work correctly, all namespace bindings
37: * for an element must be declared between its startElement method and
38: * its endAttributes event. Calling the same method with the same
39: * parameter between the endAttributes and the endElement returns
40: * the same prefix.
41: *
42: * @param requirePrefix
43: * If this parameter is true, this method must assign a prefix
44: * to this namespace, even if it's already bound to the default
45: * namespace. IOW, this method will never return null if this
46: * flag is true. This functionality is necessary to declare
47: * namespace URI used for attribute names.
48: * @param preferedPrefix
49: * If the caller has any particular preference to the
50: * prefix, pass that as a parameter. The callee will try
51: * to honor it. Set null if there's no particular preference.
52: *
53: * @return
54: * returns the assigned prefix. If the namespace is bound to
55: * the default namespace, null is returned.
56: */
57: String declareNamespace(String namespaceUri, String preferedPrefix,
58: boolean requirePrefix);
59: }
|