001: /**
002: * <copyright>
003: * </copyright>
004: *
005: * $Id: InsertElementType.java 7522 2007-09-12 22:00:10Z saul.farber $
006: */package net.opengis.wfs;
007:
008: import java.net.URI;
009:
010: import org.eclipse.emf.common.util.EList;
011: import org.eclipse.emf.ecore.EObject;
012:
013: /**
014: * <!-- begin-user-doc -->
015: * A representation of the model object '<em><b>Insert Element Type</b></em>'.
016: * <!-- end-user-doc -->
017: *
018: * <!-- begin-model-doc -->
019: *
020: * An Insert element may contain a feature collection or one
021: * or more feature instances to be inserted into the
022: * repository.
023: * <!-- end-model-doc -->
024: *
025: * <p>
026: * The following features are supported:
027: * <ul>
028: * <li>{@link net.opengis.wfs.InsertElementType#getFeature <em>Feature</em>}</li>
029: * <li>{@link net.opengis.wfs.InsertElementType#getHandle <em>Handle</em>}</li>
030: * <li>{@link net.opengis.wfs.InsertElementType#getIdgen <em>Idgen</em>}</li>
031: * <li>{@link net.opengis.wfs.InsertElementType#getInputFormat <em>Input Format</em>}</li>
032: * <li>{@link net.opengis.wfs.InsertElementType#getSrsName <em>Srs Name</em>}</li>
033: * </ul>
034: * </p>
035: *
036: * @see net.opengis.wfs.WfsPackage#getInsertElementType()
037: * @model extendedMetaData="name='InsertElementType' kind='elementOnly'"
038: * @generated
039: */
040: public interface InsertElementType extends EObject {
041: /**
042: * Returns the value of the '<em><b>Feature</b></em>' attribute list.
043: * The list contents are of type {@link java.lang.Object}.
044: * <!-- begin-user-doc -->
045: * <p>
046: * If the meaning of the '<em>Feature</em>' attribute list isn't clear,
047: * there really should be more of a description here...
048: * </p>
049: * <!-- end-user-doc -->
050: * @return the value of the '<em>Feature</em>' attribute list.
051: * @see net.opengis.wfs.WFSPackage#getInsertElementType_Feature()
052: * @model type="java.lang.Object"
053: */
054: EList getFeature();
055:
056: /**
057: * Returns the value of the '<em><b>Handle</b></em>' attribute.
058: * <!-- begin-user-doc -->
059: * <!-- end-user-doc -->
060: * <!-- begin-model-doc -->
061: *
062: * The handle attribute allows a client application
063: * to assign a client-generated request identifier
064: * to an Insert action. The handle is included to
065: * facilitate error reporting. If an Insert action
066: * in a Transaction request fails, then a WFS may
067: * include the handle in an exception report to localize
068: * the error. If no handle is included of the offending
069: * Insert element then a WFS may employee other means of
070: * localizing the error (e.g. line number).
071: * <!-- end-model-doc -->
072: * @return the value of the '<em>Handle</em>' attribute.
073: * @see #setHandle(String)
074: * @see net.opengis.wfs.WfsPackage#getInsertElementType_Handle()
075: * @model unique="false" dataType="org.eclipse.emf.ecore.xml.type.String"
076: * extendedMetaData="kind='attribute' name='handle'"
077: * @generated
078: */
079: String getHandle();
080:
081: /**
082: * Sets the value of the '{@link net.opengis.wfs.InsertElementType#getHandle <em>Handle</em>}' attribute.
083: * <!-- begin-user-doc -->
084: * <!-- end-user-doc -->
085: * @param value the new value of the '<em>Handle</em>' attribute.
086: * @see #getHandle()
087: * @generated
088: */
089: void setHandle(String value);
090:
091: /**
092: * Returns the value of the '<em><b>Idgen</b></em>' attribute.
093: * The default value is <code>"GenerateNew"</code>.
094: * The literals are from the enumeration {@link net.opengis.wfs.IdentifierGenerationOptionType}.
095: * <!-- begin-user-doc -->
096: * <!-- end-user-doc -->
097: * <!-- begin-model-doc -->
098: *
099: * The idgen attribute control how a WFS generates identifiers
100: * from newly created feature instances using the Insert action.
101: * The default action is to have the WFS generate a new id for
102: * the features. This is also backward compatible with WFS 1.0
103: * where the only action was for the WFS to generate an new id.
104: * <!-- end-model-doc -->
105: * @return the value of the '<em>Idgen</em>' attribute.
106: * @see net.opengis.wfs.IdentifierGenerationOptionType
107: * @see #isSetIdgen()
108: * @see #unsetIdgen()
109: * @see #setIdgen(IdentifierGenerationOptionType)
110: * @see net.opengis.wfs.WfsPackage#getInsertElementType_Idgen()
111: * @model default="GenerateNew" unique="false" unsettable="true"
112: * extendedMetaData="kind='attribute' name='idgen'"
113: * @generated
114: */
115: IdentifierGenerationOptionType getIdgen();
116:
117: /**
118: * Sets the value of the '{@link net.opengis.wfs.InsertElementType#getIdgen <em>Idgen</em>}' attribute.
119: * <!-- begin-user-doc -->
120: * <!-- end-user-doc -->
121: * @param value the new value of the '<em>Idgen</em>' attribute.
122: * @see net.opengis.wfs.IdentifierGenerationOptionType
123: * @see #isSetIdgen()
124: * @see #unsetIdgen()
125: * @see #getIdgen()
126: * @generated
127: */
128: void setIdgen(IdentifierGenerationOptionType value);
129:
130: /**
131: * Unsets the value of the '{@link net.opengis.wfs.InsertElementType#getIdgen <em>Idgen</em>}' attribute.
132: * <!-- begin-user-doc -->
133: * <!-- end-user-doc -->
134: * @see #isSetIdgen()
135: * @see #getIdgen()
136: * @see #setIdgen(IdentifierGenerationOptionType)
137: * @generated
138: */
139: void unsetIdgen();
140:
141: /**
142: * Returns whether the value of the '{@link net.opengis.wfs.InsertElementType#getIdgen <em>Idgen</em>}' attribute is set.
143: * <!-- begin-user-doc -->
144: * <!-- end-user-doc -->
145: * @return whether the value of the '<em>Idgen</em>' attribute is set.
146: * @see #unsetIdgen()
147: * @see #getIdgen()
148: * @see #setIdgen(IdentifierGenerationOptionType)
149: * @generated
150: */
151: boolean isSetIdgen();
152:
153: /**
154: * Returns the value of the '<em><b>Input Format</b></em>' attribute.
155: * The default value is <code>"text/xml; subtype=gml/3.1.1"</code>.
156: * <!-- begin-user-doc -->
157: * <!-- end-user-doc -->
158: * <!-- begin-model-doc -->
159: *
160: * This inputFormat attribute is used to indicate
161: * the format used to encode a feature instance in
162: * an Insert element. The default value of
163: * 'text/xml; subtype=gml/3.1.1' is used to indicate
164: * that feature encoding is GML3. Another example
165: * might be 'text/xml; subtype=gml/2.1.2' indicating
166: * that the feature us encoded in GML2. A WFS must
167: * declare in the capabilities document, using a
168: * Parameter element, which version of GML it supports.
169: * <!-- end-model-doc -->
170: * @return the value of the '<em>Input Format</em>' attribute.
171: * @see #isSetInputFormat()
172: * @see #unsetInputFormat()
173: * @see #setInputFormat(String)
174: * @see net.opengis.wfs.WfsPackage#getInsertElementType_InputFormat()
175: * @model default="text/xml; subtype=gml/3.1.1" unique="false" unsettable="true" dataType="org.eclipse.emf.ecore.xml.type.String"
176: * extendedMetaData="kind='attribute' name='inputFormat'"
177: * @generated
178: */
179: String getInputFormat();
180:
181: /**
182: * Sets the value of the '{@link net.opengis.wfs.InsertElementType#getInputFormat <em>Input Format</em>}' attribute.
183: * <!-- begin-user-doc -->
184: * <!-- end-user-doc -->
185: * @param value the new value of the '<em>Input Format</em>' attribute.
186: * @see #isSetInputFormat()
187: * @see #unsetInputFormat()
188: * @see #getInputFormat()
189: * @generated
190: */
191: void setInputFormat(String value);
192:
193: /**
194: * Unsets the value of the '{@link net.opengis.wfs.InsertElementType#getInputFormat <em>Input Format</em>}' attribute.
195: * <!-- begin-user-doc -->
196: * <!-- end-user-doc -->
197: * @see #isSetInputFormat()
198: * @see #getInputFormat()
199: * @see #setInputFormat(String)
200: * @generated
201: */
202: void unsetInputFormat();
203:
204: /**
205: * Returns whether the value of the '{@link net.opengis.wfs.InsertElementType#getInputFormat <em>Input Format</em>}' attribute is set.
206: * <!-- begin-user-doc -->
207: * <!-- end-user-doc -->
208: * @return whether the value of the '<em>Input Format</em>' attribute is set.
209: * @see #unsetInputFormat()
210: * @see #getInputFormat()
211: * @see #setInputFormat(String)
212: * @generated
213: */
214: boolean isSetInputFormat();
215:
216: /**
217: * Returns the value of the '<em><b>Srs Name</b></em>' attribute.
218: * <!-- begin-user-doc -->
219: * <!-- end-user-doc -->
220: * <!-- begin-model-doc -->
221: *
222: * ===== PAV 12NOV2004 ====
223: * WHY IS THIS HERE? WOULDN'T WE KNOW THE INCOMING SRS FROM THE
224: * GML GEOMETRY ELEMENTS? I ASSUME THAT IF THE INCOMING SRS
225: * DOES NOT MATCH ONE OF THE STORAGE SRS(s) THEN THE WFS WOULD
226: * EITHER PROJECT INTO THE STORAGE SRS OR RAISE AN EXCEPTION.
227: *
228: * <!-- end-model-doc -->
229: * @return the value of the '<em>Srs Name</em>' attribute.
230: * @see #setSrsName(String)
231: * @see net.opengis.wfs.WFSPackage#getInsertElementType_SrsName()
232: * @model
233: */
234: URI getSrsName();
235:
236: /**
237: * Sets the value of the '{@link net.opengis.wfs.InsertElementType#getSrsName <em>Srs Name</em>}' attribute.
238: * <!-- begin-user-doc -->
239: * <!-- end-user-doc -->
240: * @param value the new value of the '<em>Srs Name</em>' attribute.
241: * @see #getSrsName()
242: * @generated
243: */
244: void setSrsName(URI value);
245:
246: } // InsertElementType
|