annotate WebServiceExtensionsV1.1/WebServiceToolWorkflow_REST_SOAP/lib/SAWADLParser/src/javax/wadls/extensions/schema/Schema.java @ 0:049760c677de default tip

Galaxy WSExtensions added successfully
author uga-galaxy-group
date Tue, 05 Jul 2011 19:34:18 -0400
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
1 /*
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
2 * (c) Copyright IBM Corp 2004, 2005
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
3 */
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
4
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
5 package javax.wadls.extensions.schema;
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
6
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
7 import java.io.Serializable;
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
8 import java.util.List;
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
9 import java.util.Map;
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
10
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
11 import javax.wadls.extensions.ExtensibilityElement;
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
12 import javax.xml.namespace.QName;
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
13
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
14 import org.w3c.dom.Element;
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
15
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
16 /**
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
17 * Represents a schema element.
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
18 * This is a lightweight schema wrapper that provides access to
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
19 * the schema DOM element, but does not parse the schema details.
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
20 * The implementor may provide alternative schema parsing if required.
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
21 *
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
22 * @author Jeremy Hughes
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
23 *
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
24 */
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
25 public interface Schema extends Serializable
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
26 {
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
27 /**
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
28 * Get a map of lists containing all the imports defined here.
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
29 * The map's keys are the namespaceURIs, and the map's values
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
30 * are lists. There is one list for each namespaceURI for which
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
31 * imports have been defined.
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
32 *
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
33 * @return a map of lists of schema imports
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
34 */
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
35
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
36 public void setElementType(QName elementType);
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
37
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
38 /**
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
39 * Get the type of this extensibility element.
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
40 *
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
41 * @return the extensibility element's type
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
42 */
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
43 public QName getElementType();
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
44
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
45 /**
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
46 * Set whether or not the semantics of this extension
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
47 * are required. Relates to the wsdl:required attribute.
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
48 */
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
49 public void setRequired(Boolean required);
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
50
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
51 /**
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
52 * Get whether or not the semantics of this extension
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
53 * are required. Relates to the wsdl:required attribute.
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
54 */
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
55 public Boolean getRequired();
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
56 public Map getImports();
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
57
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
58 /**
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
59 * Create a new schema import
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
60 *
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
61 * @return the newly created schema import
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
62 */
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
63 public SchemaImport createImport();
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
64
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
65 /**
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
66 * Add an import to this LightWeightSchema
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
67 *
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
68 * @param importSchema the import to be added
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
69 */
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
70 public void addImport(SchemaImport importSchema);
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
71
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
72 /**
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
73 * Get a list containing all of the includes defined here.
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
74 * The list elements are schema references.
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
75 *
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
76 * @return a list of schema references.
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
77 */
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
78 public List getIncludes();
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
79
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
80 /**
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
81 * Create a new schema reference to represent an include.
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
82 *
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
83 * @return the newly created SchemaReference
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
84 */
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
85 public SchemaReference createInclude();
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
86
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
87 /**
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
88 * Add an include to this LightWeightSchema
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
89 *
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
90 * @param includeSchema The include to be added, represented as a SchemaReference
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
91 */
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
92 public void addInclude(SchemaReference includeSchema);
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
93
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
94 /**
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
95 * Get a list containing all of the redefines defined here.
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
96 * The list elements are schema references.
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
97 *
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
98 * @return a list of schema references.
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
99 */
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
100 public List getRedefines();
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
101
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
102 /**
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
103 * Create a new schema reference to represent a redefine.
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
104 *
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
105 * @return the newly created SchemaReference
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
106 */
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
107 public SchemaReference createRedefine();
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
108
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
109 /**
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
110 * Add a redefine to this LightWeightSchema
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
111 *
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
112 * @param redefineSchema The redefine to be added, represented as a SchemaReference
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
113 */
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
114 public void addRedefine(SchemaReference redefineSchema);
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
115
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
116 /**
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
117 * Set the DOM Element that represents this schema element.
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
118 *
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
119 * @param element the DOM element representing this schema
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
120 */
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
121 public void setElement(Element element);
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
122
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
123 /**
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
124 * Get the DOM Element that represents this schema element.
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
125 *
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
126 * @return the DOM element representing this schema
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
127 */
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
128 public Element getElement();
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
129
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
130 /**
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
131 * Set the document base URI of this schema definition. Can be used to
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
132 * represent the origin of the schema, and can be exploited
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
133 * when resolving relative URIs (e.g. in <import>s).
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
134 *
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
135 * @param documentBaseURI the document base URI of this schema
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
136 */
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
137 public void setDocumentBaseURI(String documentBaseURI);
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
138
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
139 /**
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
140 * Get the document base URI of this schema
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
141 *
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
142 * @return the document base URI
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
143 */
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
144 public String getDocumentBaseURI();
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
145
049760c677de Galaxy WSExtensions added successfully
uga-galaxy-group
parents:
diff changeset
146 }