You are viewing a plain text version of this content. The canonical link for it is here.
Posted to java-dev@axis.apache.org by di...@apache.org on 2005/11/29 17:53:17 UTC
svn commit: r349758 [1/2] - in /webservices/axis2/trunk/java/modules:
codegen/src/org/apache/axis2/databinding/
core/src/org/apache/axis2/deployment/ core/src/org/apache/axis2/engine/
core/src/org/apache/axis2/transport/http/
Author: dims
Date: Tue Nov 29 08:53:03 2005
New Revision: 349758
URL: http://svn.apache.org/viewcvs?rev=349758&view=rev
Log:
javadoc changes + i change of a method name to fix spelling mistake
Modified:
webservices/axis2/trunk/java/modules/codegen/src/org/apache/axis2/databinding/ADBBean.java
webservices/axis2/trunk/java/modules/codegen/src/org/apache/axis2/databinding/Constants.java
webservices/axis2/trunk/java/modules/codegen/src/org/apache/axis2/databinding/Holder.java
webservices/axis2/trunk/java/modules/codegen/src/org/apache/axis2/databinding/MultiTarget.java
webservices/axis2/trunk/java/modules/codegen/src/org/apache/axis2/databinding/SerializationContext.java
webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/deployment/DeploymentEngine.java
webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AbstractDispatcher.java
webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AddressingBasedDispatcher.java
webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AxisConfiguration.java
webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AxisConfigurationImpl.java
webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AxisEngine.java
webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AxisEvent.java
webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/DependencyManager.java
webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/DispatchingChecker.java
webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/Handler.java
webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/InstanceDispatcher.java
webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/MessageReceiver.java
webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/Phase.java
webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/RequestURIBasedDispatcher.java
webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/SOAPActionBasedDispatcher.java
webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/SOAPMessageBodyBasedDispatcher.java
webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/transport/http/ListingAgent.java
Modified: webservices/axis2/trunk/java/modules/codegen/src/org/apache/axis2/databinding/ADBBean.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/codegen/src/org/apache/axis2/databinding/ADBBean.java?rev=349758&r1=349757&r2=349758&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/codegen/src/org/apache/axis2/databinding/ADBBean.java (original)
+++ webservices/axis2/trunk/java/modules/codegen/src/org/apache/axis2/databinding/ADBBean.java Tue Nov 29 08:53:03 2005
@@ -1,42 +1,42 @@
-package org.apache.axis2.databinding;
-
-import javax.xml.namespace.QName;
-import javax.xml.stream.XMLStreamReader;
-
-/*
- * Copyright 2001-2004 The Apache Software Foundation.
- *
- * Licensed under the Apache License, Version 2.0 (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.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * @author : Eran Chinthaka (chinthaka@apache.org)
- *
- * ADBBean - Axis Data Binding Bean. This will be implemented by all the beans that are being generated by
- * Axis2 data binding framework
- */
-
-public interface ADBBean {
- /**
- * This method is used to serialize an ADBBean: get the pull parser and pull
- * the XML pull events to represent the bean.
- *
- * @param adbBeanQName
- * the name of the element to be generated for this ADBBean
- * @return a pull parser for this ADBBean.
- */
- public XMLStreamReader getPullParser(QName adbBeanQName);
-
- /**
- * There will be a self factory in every generated data bound class XXX:
- * public static XXX read (XMLStreamReader);
- */
-}
+package org.apache.axis2.databinding;
+
+import javax.xml.namespace.QName;
+import javax.xml.stream.XMLStreamReader;
+
+/*
+ * Copyright 2001-2004 The Apache Software Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0 (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.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author : Eran Chinthaka (chinthaka@apache.org)
+ *
+ * ADBBean - Axis Data Binding Bean. This will be implemented by all the beans that are being generated by
+ * Axis2 data binding framework
+ */
+
+public interface ADBBean {
+ /**
+ * Serializes an ADBBean. Gets the pull parser and fetches the XML pull
+ * events to represent the bean.
+ *
+ * @param adbBeanQName
+ * the name of the element to be generated for this ADBBean.
+ * @return Returns a pull parser for this ADBBean.
+ */
+ public XMLStreamReader getPullParser(QName adbBeanQName);
+
+ /**
+ * There will be a self factory in every generated data bound class XXX:
+ * public static XXX read (XMLStreamReader);
+ */
+}
Modified: webservices/axis2/trunk/java/modules/codegen/src/org/apache/axis2/databinding/Constants.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/codegen/src/org/apache/axis2/databinding/Constants.java?rev=349758&r1=349757&r2=349758&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/codegen/src/org/apache/axis2/databinding/Constants.java (original)
+++ webservices/axis2/trunk/java/modules/codegen/src/org/apache/axis2/databinding/Constants.java Tue Nov 29 08:53:03 2005
@@ -1,698 +1,696 @@
-/*
- * Copyright 2001-2004 The Apache Software Foundation.
- *
- * Licensed under the Apache License, Version 2.0 (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.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package org.apache.axis2.databinding;
-
-
-import org.xml.sax.Attributes;
-
-import javax.xml.namespace.QName;
-
-public class Constants {
- // Some common Constants that should be used in local handler options
- // (Not all implementations will have these concepts - for example
- // not all Engines will have notion of registries but defining these
- // here should allow people to ask if they exist)
- //////////////////////////////////////////////////////////////////////////
-
- // Namespace Prefix Constants
- //////////////////////////////////////////////////////////////////////////
- public static final String NS_PREFIX_SOAP_ENV = "soapenv";
- public static final String NS_PREFIX_SOAP_ENC = "soapenc";
- public static final String NS_PREFIX_SCHEMA_XSI = "xsi" ;
- public static final String NS_PREFIX_SCHEMA_XSD = "xsd" ;
- public static final String NS_PREFIX_WSDL = "wsdl" ;
- public static final String NS_PREFIX_WSDL_SOAP = "wsdlsoap";
- public static final String NS_PREFIX_XMLSOAP = "apachesoap";
- public static final String NS_PREFIX_XML = "xml";
-
- // Axis Namespaces
- public static final String NS_URI_AXIS = "http://xml.apache.org/axis/";
- public static final String NS_URI_XMLSOAP = "http://xml.apache.org/xml-soap";
-
- // Special namespace URI to indicate an "automatically" serialized Java
- // type. This allows us to use types without needing explicit mappings,
- // such that Java classes like "org.foo.Bar" map to QNames like
- // {http://xml.apache.org/axis/java}org.foo.Bar
- public static final String NS_URI_JAVA = "http://xml.apache.org/axis/java";
-
-
- //
- // SOAP-ENV Namespaces
- //
- public static final String URI_SOAP11_ENV =
- "http://schemas.xmlsoap.org/soap/envelope/" ;
- public static final String URI_SOAP12_ENV =
- "http://www.w3.org/2003/05/soap-envelope";
-
- // fixme: this is unsafe - a client can (accidentaly or on purpose)
- // over-write the elemnts of this array. This pattern is used throughout
- // this file.
- public static final String[] URIS_SOAP_ENV = {
- URI_SOAP11_ENV,
- URI_SOAP12_ENV,
- };
-
- // Constant name of the enterprise-style logging category.
- // The enterprise category is for stuff that an enterprise product might
- // want to track, but in a simple environment (like the AXIS build) would
- // be nothing more than a nuisance.
- public static final String ENTERPRISE_LOG_CATEGORY = "org.apache.axis.enterprise";
-
- /**
- * time logged stuff.
- */
- public static final String TIME_LOG_CATEGORY = "org.apache.axis.TIME";
-
- /**
- * Servlet exceptions. Axis faults are logged at debug level here.
- */
- public static final String EXCEPTION_LOG_CATEGORY = "org.apache.axis.EXCEPTIONS";
-
- /** The name of the field which accepts xsd:any content in Beans. */
- public static final String ANYCONTENT = "_any";
- /**
- * The size of the buffer size for.
- */
- public static final int HTTP_TXR_BUFFER_SIZE = 8 * 1024;
-
- /** Basic Profile 1.1 compatibility flag */
- public static final String WSIBP11_COMPAT_PROPERTY = "axis.ws-i.bp11.compatibility";
-
- /**
- * Returns true if the string is the SOAP_ENV Namespace.
- *
- * @param s the string representation of a URI
- * @return <code>true</code> if s represents any of the supported soap
- * envelope URI strings
- */
- public static boolean isSOAP_ENV(String s) {
- for (int i=0; i<URIS_SOAP_ENV.length; i++) {
- if (URIS_SOAP_ENV[i].equals(s)) {
- return true;
- }
- }
- return false;
- }
-
-
- public static final String URI_LITERAL_ENC = "";
-
- //
- // SOAP-ENC Namespaces
- //
- public static final String URI_SOAP11_ENC =
- "http://schemas.xmlsoap.org/soap/encoding/" ;
- public static final String URI_SOAP12_ENC =
- "http://www.w3.org/2003/05/soap-encoding";
- public static final String URI_SOAP12_NOENC =
- "http://www.w3.org/2003/05/soap-envelope/encoding/none";
-
- public static final String[] URIS_SOAP_ENC = {
- URI_SOAP12_ENC,
- URI_SOAP11_ENC,
- };
-
- /**
- * Returns true if SOAP_ENC Namespace.
- *
- * @param s a string representing the URI to check
- * @return true if <code>s</code> matches a SOAP ENCODING namespace URI,
- * false otherwise
- */
- public static boolean isSOAP_ENC(String s) {
- for (int i=0; i<URIS_SOAP_ENC.length; i++) {
- if (URIS_SOAP_ENC[i].equals(s)) {
- return true;
- }
- }
- return false;
- }
-
- /**
- * This utility routine returns the value of an attribute which might
- * be in one of several namespaces.
- *
- * @param attributes the attributes to search
- * @param search an array of namespace URI strings to search
- * @param localPart is the local part of the attribute name
- * @return the value of the attribute or null
- */
- public static String getValue(Attributes attributes,
- String [] search,
- String localPart) {
- if (attributes == null || search == null || localPart == null) {
- return null;
- }
-
- int len = attributes.getLength();
-
- if (len == 0) {
- return null;
- }
-
- for (int i=0; i < len; i++) {
- if (attributes.getLocalName(i).equals(localPart)) {
- String uri = attributes.getURI(i);
- for (int j=0; j<search.length; j++) {
- if (search[j].equals(uri)) return attributes.getValue(i);
- }
- }
- }
-
- return null;
- }
-
- /**
- * Search an attribute collection for a list of QNames, returning
- * the value of the first one found, or null if none were found.
- *
- * @param attributes
- * @param search
- * @return the value of the attribute
- */
- public static String getValue(Attributes attributes,
- QName [] search) {
- if (attributes == null || search == null)
- return null;
-
- if (attributes.getLength() == 0) return null;
-
- String value = null;
- for (int i=0; (value == null) && (i < search.length); i++) {
- value = attributes.getValue(search[i].getNamespaceURI(),
- search[i].getLocalPart());
- }
-
- return value;
- }
-
- /**
- * equals
- * The first QName is the current version of the name. The second qname is compared
- * with the first considering all namespace uri versions.
- * @param first Currently supported QName
- * @param second any qname
- * @return true if the qnames represent the same qname (paster namespace uri versions considered
- */
- public static boolean equals(QName first, QName second) {
- if (first == second) {
- return true;
- }
- if (first==null || second==null) {
- return false;
- }
- if (first.equals(second)) {
- return true;
- }
- if (!first.getLocalPart().equals(second.getLocalPart())) {
- return false;
- }
-
- String namespaceURI = first.getNamespaceURI();
- String[] search = null;
- if (namespaceURI.equals(URI_DEFAULT_SCHEMA_XSD))
- search = URIS_SCHEMA_XSD;
- else if (namespaceURI.equals(URI_DEFAULT_SCHEMA_XSI))
- search = URIS_SCHEMA_XSI;
- else
- search = new String[] {namespaceURI};
-
- for (int i=0; i < search.length; i++) {
- if (search[i].equals(second.getNamespaceURI())) {
- return true;
- }
- }
- return false;
- }
-
- // Misc SOAP Namespaces / URIs
- public static final String URI_SOAP11_NEXT_ACTOR =
- "http://schemas.xmlsoap.org/soap/actor/next" ;
- public static final String URI_SOAP12_NEXT_ROLE =
- "http://www.w3.org/2003/05/soap-envelope/role/next";
- /** @deprecated use URI_SOAP12_NEXT_ROLE */
- public static final String URI_SOAP12_NEXT_ACTOR = URI_SOAP12_NEXT_ROLE;
-
- public static final String URI_SOAP12_RPC =
- "http://www.w3.org/2003/05/soap-rpc";
-
- public static final String URI_SOAP12_NONE_ROLE =
- "http://www.w3.org/2003/05/soap-envelope/role/none";
- public static final String URI_SOAP12_ULTIMATE_ROLE =
- "http://www.w3.org/2003/05/soap-envelope/role/ultimateReceiver";
-
- public static final String URI_SOAP11_HTTP =
- "http://schemas.xmlsoap.org/soap/http";
- public static final String URI_SOAP12_HTTP =
- "http://www.w3.org/2003/05/http";
-
- public static final String NS_URI_XMLNS =
- "http://www.w3.org/2000/xmlns/";
-
- public static final String NS_URI_XML =
- "http://www.w3.org/XML/1998/namespace";
-
- //
- // Schema XSD Namespaces
- //
- public static final String URI_1999_SCHEMA_XSD =
- "http://www.w3.org/1999/XMLSchema";
- public static final String URI_2000_SCHEMA_XSD =
- "http://www.w3.org/2000/10/XMLSchema";
- public static final String URI_2001_SCHEMA_XSD =
- "http://www.w3.org/2001/XMLSchema";
-
- public static final String URI_DEFAULT_SCHEMA_XSD = URI_2001_SCHEMA_XSD;
-
- public static final String[] URIS_SCHEMA_XSD = {
- URI_1999_SCHEMA_XSD,
- URI_2000_SCHEMA_XSD,
- URI_2001_SCHEMA_XSD
- };
-
-
- /**
- * Returns true if SchemaXSD Namespace.
- *
- * @param s the string representing the URI to check
- * @return true if s represents the Schema XSD namespace, false otherwise
- */
- public static boolean isSchemaXSD(String s) {
- for (int i=0; i<URIS_SCHEMA_XSD.length; i++) {
- if (URIS_SCHEMA_XSD[i].equals(s)) {
- return true;
- }
- }
- return false;
- }
-
- //
- // Schema XSI Namespaces
- //
- public static final String URI_1999_SCHEMA_XSI =
- "http://www.w3.org/1999/XMLSchema-instance";
- public static final String URI_2000_SCHEMA_XSI =
- "http://www.w3.org/2000/10/XMLSchema-instance";
- public static final String URI_2001_SCHEMA_XSI =
- "http://www.w3.org/2001/XMLSchema-instance";
- public static final String URI_DEFAULT_SCHEMA_XSI = URI_2001_SCHEMA_XSI;
-
- public static final String[] URIS_SCHEMA_XSI = {
- URI_1999_SCHEMA_XSI,
- URI_2000_SCHEMA_XSI,
- URI_2001_SCHEMA_XSI,
- };
-
- /**
- * Returns true if SchemaXSI Namespace.
- *
- * @param s the string of the URI to check
- * @return true if <code>s</code> is a Schema XSI URI, false otherwise
- */
- public static boolean isSchemaXSI(String s) {
- for (int i=0; i<URIS_SCHEMA_XSI.length; i++) {
- if (URIS_SCHEMA_XSI[i].equals(s)) {
- return true;
- }
- }
- return false;
- }
-
- /**
- * WSDL Namespace.
- */
- public static final String NS_URI_WSDL11 =
- "http://schemas.xmlsoap.org/wsdl/";
-
- public static final String[] NS_URIS_WSDL = {
- NS_URI_WSDL11,
- };
-
- /**
- * Returns true if this is a WSDL Namespace.
- *
- * @param s a string of a URI to check
- * @return true if <code>s</code> is a WSDL namespace URI, false otherwise
- */
- public static boolean isWSDL(String s) {
- for (int i=0; i<NS_URIS_WSDL.length; i++) {
- if (NS_URIS_WSDL[i].equals(s)) {
- return true;
- }
- }
- return false;
- }
-
- //
- // WSDL extensions for SOAP in DIME
- // (http://gotdotnet.com/team/xml_wsspecs/dime/WSDL-Extension-for-DIME.htm)
- //
- public static final String URI_DIME_WSDL =
- "http://schemas.xmlsoap.org/ws/2002/04/dime/wsdl/";
-
- public static final String URI_DIME_CONTENT =
- "http://schemas.xmlsoap.org/ws/2002/04/content-type/";
-
- public static final String URI_DIME_REFERENCE=
- "http://schemas.xmlsoap.org/ws/2002/04/reference/";
-
- public static final String URI_DIME_CLOSED_LAYOUT=
- "http://schemas.xmlsoap.org/ws/2002/04/dime/closed-layout";
-
- public static final String URI_DIME_OPEN_LAYOUT=
- "http://schemas.xmlsoap.org/ws/2002/04/dime/open-layout";
-
- //
- // WSDL SOAP Namespace
- //
- public static final String URI_WSDL11_SOAP =
- "http://schemas.xmlsoap.org/wsdl/soap/";
- public static final String URI_WSDL12_SOAP =
- "http://schemas.xmlsoap.org/wsdl/soap12/";
-
- public static final String[] NS_URIS_WSDL_SOAP = {
- URI_WSDL11_SOAP,
- URI_WSDL12_SOAP
- };
-
- /**
- * Returns true if s is a WSDL SOAP Namespace.
- *
- * @param s a string of a URI to check
- * @return true if <code>s</code> matches any of the WSDL SOAP namepace
- * URIs, false otherwise
- */
- public static boolean isWSDLSOAP(String s) {
- for (int i=0; i<NS_URIS_WSDL_SOAP.length; i++) {
- if (NS_URIS_WSDL_SOAP[i].equals(s)) {
- return true;
- }
- }
- return false;
- }
-
- // Axis Mechanism Type
- public static final String AXIS_SAX = "Axis SAX Mechanism";
-
- public static final String ELEM_ENVELOPE = "Envelope" ;
- public static final String ELEM_HEADER = "Header" ;
- public static final String ELEM_BODY = "Body" ;
- public static final String ELEM_FAULT = "Fault" ;
-
- public static final String ELEM_NOTUNDERSTOOD = "NotUnderstood";
- public static final String ELEM_UPGRADE = "Upgrade";
- public static final String ELEM_SUPPORTEDENVELOPE = "SupportedEnvelope";
-
- public static final String ELEM_FAULT_CODE = "faultcode" ;
- public static final String ELEM_FAULT_STRING = "faultstring" ;
- public static final String ELEM_FAULT_DETAIL = "detail" ;
- public static final String ELEM_FAULT_ACTOR = "faultactor" ;
-
- public static final String ELEM_FAULT_CODE_SOAP12 = "Code" ;
- public static final String ELEM_FAULT_VALUE_SOAP12 = "Value" ;
- public static final String ELEM_FAULT_SUBCODE_SOAP12 = "Subcode" ;
- public static final String ELEM_FAULT_REASON_SOAP12 = "Reason" ;
- public static final String ELEM_FAULT_NODE_SOAP12 = "Node" ;
- public static final String ELEM_FAULT_ROLE_SOAP12 = "Role" ;
- public static final String ELEM_FAULT_DETAIL_SOAP12 = "Detail" ;
- public static final String ELEM_TEXT_SOAP12 = "Text" ;
-
- public static final String ATTR_MUST_UNDERSTAND = "mustUnderstand" ;
- public static final String ATTR_ENCODING_STYLE = "encodingStyle" ;
- public static final String ATTR_ACTOR = "actor" ;
- public static final String ATTR_ROLE = "role" ;
- public static final String ATTR_RELAY = "relay" ;
- public static final String ATTR_ROOT = "root" ;
- public static final String ATTR_ID = "id" ;
- public static final String ATTR_HREF = "href" ;
- public static final String ATTR_REF = "ref" ;
- public static final String ATTR_QNAME = "qname";
- public static final String ATTR_ARRAY_TYPE = "arrayType";
- public static final String ATTR_ITEM_TYPE = "itemType";
- public static final String ATTR_ARRAY_SIZE = "arraySize";
- public static final String ATTR_OFFSET = "offset";
- public static final String ATTR_POSITION = "position";
- public static final String ATTR_TYPE = "type";
- public static final String ATTR_HANDLERINFOCHAIN = "handlerInfoChain";
-
- // Fault Codes
- //////////////////////////////////////////////////////////////////////////
- public static final String FAULT_CLIENT = "Client";
-
- public static final String FAULT_SERVER_GENERAL =
- "Server.generalException";
-
- public static final String FAULT_SERVER_USER =
- "Server.userException";
-
- public static final QName FAULT_VERSIONMISMATCH =
- new QName(URI_SOAP11_ENV, "VersionMismatch");
-
- public static final QName FAULT_MUSTUNDERSTAND =
- new QName(URI_SOAP11_ENV, "MustUnderstand");
-
-
- public static final QName FAULT_SOAP12_MUSTUNDERSTAND =
- new QName(URI_SOAP12_ENV, "MustUnderstand");
-
- public static final QName FAULT_SOAP12_VERSIONMISMATCH =
- new QName(URI_SOAP12_ENV, "VersionMismatch");
-
- public static final QName FAULT_SOAP12_DATAENCODINGUNKNOWN =
- new QName(URI_SOAP12_ENV, "DataEncodingUnknown");
-
- public static final QName FAULT_SOAP12_SENDER =
- new QName(URI_SOAP12_ENV, "Sender");
-
- public static final QName FAULT_SOAP12_RECEIVER =
- new QName(URI_SOAP12_ENV, "Receiver");
-
- // SOAP 1.2 Fault subcodes
- public static final QName FAULT_SUBCODE_BADARGS =
- new QName(URI_SOAP12_RPC, "BadArguments");
- public static final QName FAULT_SUBCODE_PROC_NOT_PRESENT =
- new QName(URI_SOAP12_RPC, "ProcedureNotPresent");
-
- // QNames
- //////////////////////////////////////////////////////////////////////////
- public static final QName QNAME_FAULTCODE =
- new QName("", ELEM_FAULT_CODE);
- public static final QName QNAME_FAULTSTRING =
- new QName("", ELEM_FAULT_STRING);
- public static final QName QNAME_FAULTACTOR =
- new QName("", ELEM_FAULT_ACTOR);
- public static final QName QNAME_FAULTDETAILS =
- new QName("", ELEM_FAULT_DETAIL);
-
- public static final QName QNAME_FAULTCODE_SOAP12 =
- new QName(URI_SOAP12_ENV, ELEM_FAULT_CODE_SOAP12);
- public static final QName QNAME_FAULTVALUE_SOAP12 =
- new QName(URI_SOAP12_ENV, ELEM_FAULT_VALUE_SOAP12);
- public static final QName QNAME_FAULTSUBCODE_SOAP12 =
- new QName(URI_SOAP12_ENV, ELEM_FAULT_SUBCODE_SOAP12);
- public static final QName QNAME_FAULTREASON_SOAP12 =
- new QName(URI_SOAP12_ENV, ELEM_FAULT_REASON_SOAP12);
- public static final QName QNAME_TEXT_SOAP12 =
- new QName(URI_SOAP12_ENV, ELEM_TEXT_SOAP12);
-
- public static final QName QNAME_FAULTNODE_SOAP12 =
- new QName(URI_SOAP12_ENV, ELEM_FAULT_NODE_SOAP12);
- public static final QName QNAME_FAULTROLE_SOAP12 =
- new QName(URI_SOAP12_ENV, ELEM_FAULT_ROLE_SOAP12);
- public static final QName QNAME_FAULTDETAIL_SOAP12 =
- new QName(URI_SOAP12_ENV, ELEM_FAULT_DETAIL_SOAP12);
- public static final QName QNAME_NOTUNDERSTOOD =
- new QName(URI_SOAP12_ENV, ELEM_NOTUNDERSTOOD);
-
- // Define qnames for the all of the XSD and SOAP-ENC encodings
- public static final QName XSD_STRING = new QName(URI_DEFAULT_SCHEMA_XSD, "string");
- public static final QName XSD_BOOLEAN = new QName(URI_DEFAULT_SCHEMA_XSD, "boolean");
- public static final QName XSD_DOUBLE = new QName(URI_DEFAULT_SCHEMA_XSD, "double");
- public static final QName XSD_FLOAT = new QName(URI_DEFAULT_SCHEMA_XSD, "float");
- public static final QName XSD_INT = new QName(URI_DEFAULT_SCHEMA_XSD, "int");
- public static final QName XSD_INTEGER = new QName(URI_DEFAULT_SCHEMA_XSD, "integer");
- public static final QName XSD_LONG = new QName(URI_DEFAULT_SCHEMA_XSD, "long");
- public static final QName XSD_SHORT = new QName(URI_DEFAULT_SCHEMA_XSD, "short");
- public static final QName XSD_BYTE = new QName(URI_DEFAULT_SCHEMA_XSD, "byte");
- public static final QName XSD_DECIMAL = new QName(URI_DEFAULT_SCHEMA_XSD, "decimal");
- public static final QName XSD_BASE64 = new QName(URI_DEFAULT_SCHEMA_XSD, "base64Binary");
- public static final QName XSD_HEXBIN = new QName(URI_DEFAULT_SCHEMA_XSD, "hexBinary");
- public static final QName XSD_ANYSIMPLETYPE = new QName(URI_DEFAULT_SCHEMA_XSD, "anySimpleType");
- public static final QName XSD_ANYTYPE = new QName(URI_DEFAULT_SCHEMA_XSD, "anyType");
- public static final QName XSD_ANY = new QName(URI_DEFAULT_SCHEMA_XSD, "any");
- public static final QName XSD_QNAME = new QName(URI_DEFAULT_SCHEMA_XSD, "QName");
- public static final QName XSD_DATETIME = new QName(URI_DEFAULT_SCHEMA_XSD, "dateTime");
- public static final QName XSD_DATE = new QName(URI_DEFAULT_SCHEMA_XSD, "date");
- public static final QName XSD_TIME = new QName(URI_DEFAULT_SCHEMA_XSD, "time");
- public static final QName XSD_TIMEINSTANT1999 = new QName(URI_1999_SCHEMA_XSD, "timeInstant");
- public static final QName XSD_TIMEINSTANT2000 = new QName(URI_2000_SCHEMA_XSD, "timeInstant");
-
- public static final QName XSD_NORMALIZEDSTRING = new QName(URI_2001_SCHEMA_XSD, "normalizedString");
- public static final QName XSD_TOKEN = new QName(URI_2001_SCHEMA_XSD, "token");
-
- public static final QName XSD_UNSIGNEDLONG = new QName(URI_2001_SCHEMA_XSD, "unsignedLong");
- public static final QName XSD_UNSIGNEDINT = new QName(URI_2001_SCHEMA_XSD, "unsignedInt");
- public static final QName XSD_UNSIGNEDSHORT = new QName(URI_2001_SCHEMA_XSD, "unsignedShort");
- public static final QName XSD_UNSIGNEDBYTE = new QName(URI_2001_SCHEMA_XSD, "unsignedByte");
- public static final QName XSD_POSITIVEINTEGER = new QName(URI_2001_SCHEMA_XSD, "positiveInteger");
- public static final QName XSD_NEGATIVEINTEGER = new QName(URI_2001_SCHEMA_XSD, "negativeInteger");
- public static final QName XSD_NONNEGATIVEINTEGER = new QName(URI_2001_SCHEMA_XSD, "nonNegativeInteger");
- public static final QName XSD_NONPOSITIVEINTEGER = new QName(URI_2001_SCHEMA_XSD, "nonPositiveInteger");
-
- public static final QName XSD_YEARMONTH = new QName(URI_2001_SCHEMA_XSD, "gYearMonth");
- public static final QName XSD_MONTHDAY = new QName(URI_2001_SCHEMA_XSD, "gMonthDay");
- public static final QName XSD_YEAR = new QName(URI_2001_SCHEMA_XSD, "gYear");
- public static final QName XSD_MONTH = new QName(URI_2001_SCHEMA_XSD, "gMonth");
- public static final QName XSD_DAY = new QName(URI_2001_SCHEMA_XSD, "gDay");
- public static final QName XSD_DURATION = new QName(URI_2001_SCHEMA_XSD, "duration");
-
- public static final QName XSD_NAME = new QName(URI_2001_SCHEMA_XSD, "Name");
- public static final QName XSD_NCNAME = new QName(URI_2001_SCHEMA_XSD, "NCName");
- public static final QName XSD_NMTOKEN = new QName(URI_2001_SCHEMA_XSD, "NMTOKEN");
- public static final QName XSD_NMTOKENS = new QName(URI_2001_SCHEMA_XSD, "NMTOKENS");
- public static final QName XSD_NOTATION = new QName(URI_2001_SCHEMA_XSD, "NOTATION");
- public static final QName XSD_ENTITY = new QName(URI_2001_SCHEMA_XSD, "ENTITY");
- public static final QName XSD_ENTITIES = new QName(URI_2001_SCHEMA_XSD, "ENTITIES");
- public static final QName XSD_IDREF = new QName(URI_2001_SCHEMA_XSD, "IDREF");
- public static final QName XSD_IDREFS = new QName(URI_2001_SCHEMA_XSD, "IDREFS");
- public static final QName XSD_ANYURI = new QName(URI_2001_SCHEMA_XSD, "anyURI");
- public static final QName XSD_LANGUAGE = new QName(URI_2001_SCHEMA_XSD, "language");
- public static final QName XSD_ID = new QName(URI_2001_SCHEMA_XSD, "ID");
- public static final QName XSD_SCHEMA = new QName(URI_2001_SCHEMA_XSD, "schema");
-
- public static final QName XML_LANG = new QName(NS_URI_XML, "lang");
-
-
- public static final QName SOAP_COMMON_ATTRS11 = new QName(URI_SOAP11_ENC, "commonAttributes");
- public static final QName SOAP_COMMON_ATTRS12 = new QName(URI_SOAP12_ENC, "commonAttributes");
- public static final QName SOAP_ARRAY_ATTRS11 = new QName(URI_SOAP11_ENC, "arrayAttributes");
- public static final QName SOAP_ARRAY_ATTRS12 = new QName(URI_SOAP12_ENC, "arrayAttributes");
- public static final QName SOAP_ARRAY12 = new QName(URI_SOAP12_ENC, "Array");
-
- public static final QName SOAP_MAP = new QName(NS_URI_XMLSOAP, "Map");
- public static final QName SOAP_ELEMENT = new QName(NS_URI_XMLSOAP, "Element");
- public static final QName SOAP_DOCUMENT = new QName(NS_URI_XMLSOAP, "Document");
- public static final QName SOAP_VECTOR = new QName(NS_URI_XMLSOAP, "Vector");
- public static final QName MIME_IMAGE = new QName(NS_URI_XMLSOAP, "Image");
- public static final QName MIME_PLAINTEXT = new QName(NS_URI_XMLSOAP, "PlainText");
- public static final QName MIME_MULTIPART = new QName(NS_URI_XMLSOAP, "Multipart");
- public static final QName MIME_SOURCE = new QName(NS_URI_XMLSOAP, "Source");
- public static final QName MIME_OCTETSTREAM = new QName(NS_URI_XMLSOAP, "octet-stream");
- public static final QName MIME_DATA_HANDLER = new QName(NS_URI_XMLSOAP, "DataHandler");
-
-
- public static final QName QNAME_LITERAL_ITEM = new QName(URI_LITERAL_ENC,"item");
- public static final QName QNAME_RPC_RESULT = new QName(URI_SOAP12_RPC,"result");
-
- /**
- * QName of stack trace element in an axis fault detail.
- */
- public static final QName QNAME_FAULTDETAIL_STACKTRACE = new QName(NS_URI_AXIS,"stackTrace");
-
- /**
- * QName of exception Name element in an axis fault detail.
- * Do not use - this is for pre-1.0 server->client exceptions.
- */
- public static final QName QNAME_FAULTDETAIL_EXCEPTIONNAME = new QName(NS_URI_AXIS, "exceptionName");
-
- /**
- * Flag set if this was a runtime exception, rather than something thrown by the class at the end of the
- * chain. Axis' logging treats runtime exceptions more seriously.
- */
- public static final QName QNAME_FAULTDETAIL_RUNTIMEEXCEPTION = new QName(NS_URI_AXIS, "isRuntimeException");
-
- /**
- * QName of stack trace element in an axis fault detail.
- */
- public static final QName QNAME_FAULTDETAIL_HTTPERRORCODE = new QName(NS_URI_AXIS, "HttpErrorCode");
-
- /**
- * QName of a nested fault in an axis fault detail.
- */
- public static final QName QNAME_FAULTDETAIL_NESTEDFAULT = new QName(NS_URI_AXIS, "nestedFault");
-
- /**
- * QName of a hostname in an axis fault detail.
- */
- public static final QName QNAME_FAULTDETAIL_HOSTNAME = new QName(NS_URI_AXIS, "hostname");
-
- //QNames of well known faults
- /**
- * The no-service fault value.
- */
- public static final QName QNAME_NO_SERVICE_FAULT_CODE
- = new QName(NS_URI_AXIS, "Server.NoService");
-
- // Misc Strings
- //////////////////////////////////////////////////////////////////////////
-
- // Where to put those pesky JWS classes
- public static final String MC_JWS_CLASSDIR = "jws.classDir" ;
- // Where we're rooted
- public static final String MC_HOME_DIR = "home.dir";
-
- // Relative path of the request URL (ie. http://.../axis/a.jws = /a.jws
- public static final String MC_RELATIVE_PATH = "path";
-
- // MessageContext param for the engine's path
- public static final String MC_REALPATH = "realpath";
- // MessageContext param for the location of config files
- public static final String MC_CONFIGPATH = "configPath";
- // MessageContext param for the IP of the calling client
- public static final String MC_REMOTE_ADDR = "remoteaddr";
- // When invoked from a servlet, per JAX-RPC, we need a
- // ServletEndpointContext object. This is where it lives.
- public static final String MC_SERVLET_ENDPOINT_CONTEXT = "servletEndpointContext";
-
- // If we're SOAP 1.2, the default behavior in org.apache.axis.message.BodyBuilder
- // is to throw a ProcedureNotPresent fault if we can't dispatch to an
- // OperationDesc during deserialization. Set this property to any non-null
- // value to prevent this behavior (only used by test.soap12.
- public static final String MC_NO_OPERATION_OK = "NoOperationOK";
-
- // This property indicates we're supporting only a single SOAP version.
- // If set (by the service or engine), we'll only accept envelopes of the
- // specified version. Value should be an org.apache.axis.soap.SOAPConstants
- public static final String MC_SINGLE_SOAP_VERSION = "SingleSOAPVersion";
-
- /**
- * What the extension of JWS files is. If changing this, note that
- * AxisServlet has an xdoclet declaration in the class javadocs that
- * also needs updating.
- */
- public static final String JWS_DEFAULT_FILE_EXTENSION = ".jws";
-
- /**
- * The default timeout for messages.
- *
- * @since Axis1.2
- */
- public static final int DEFAULT_MESSAGE_TIMEOUT=60*1000*10;
-
- /**
- * MIME Content Types
- *
- * @since Axis1.2
- */
- public static final String MIME_CT_APPLICATION_OCTETSTREAM = "application/octet-stream";
- public static final String MIME_CT_TEXT_PLAIN = "text/plain";
- public static final String MIME_CT_IMAGE_JPEG = "image/jpeg";
- public static final String MIME_CT_IMAGE_GIF = "image/gif";
- public static final String MIME_CT_TEXT_XML = "text/xml";
- public static final String MIME_CT_APPLICATION_XML = "application/xml";
- public static final String MIME_CT_MULTIPART_PREFIX = "multipart/";
-}
+/*
+ * Copyright 2001-2004 The Apache Software Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0 (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.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.apache.axis2.databinding;
+
+
+import org.xml.sax.Attributes;
+
+import javax.xml.namespace.QName;
+
+public class Constants {
+ // Some common Constants that should be used in local handler options
+ // (Not all implementations will have these concepts - for example
+ // not all Engines will have notion of registries but defining these
+ // here should allow people to ask if they exist)
+ //////////////////////////////////////////////////////////////////////////
+
+ // Namespace Prefix Constants
+ //////////////////////////////////////////////////////////////////////////
+ public static final String NS_PREFIX_SOAP_ENV = "soapenv";
+ public static final String NS_PREFIX_SOAP_ENC = "soapenc";
+ public static final String NS_PREFIX_SCHEMA_XSI = "xsi" ;
+ public static final String NS_PREFIX_SCHEMA_XSD = "xsd" ;
+ public static final String NS_PREFIX_WSDL = "wsdl" ;
+ public static final String NS_PREFIX_WSDL_SOAP = "wsdlsoap";
+ public static final String NS_PREFIX_XMLSOAP = "apachesoap";
+ public static final String NS_PREFIX_XML = "xml";
+
+ // Axis Namespaces
+ public static final String NS_URI_AXIS = "http://xml.apache.org/axis/";
+ public static final String NS_URI_XMLSOAP = "http://xml.apache.org/xml-soap";
+
+ // Special namespace URI to indicate an "automatically" serialized Java
+ // type. This allows us to use types without needing explicit mappings,
+ // such that Java classes like "org.foo.Bar" map to QNames like
+ // {http://xml.apache.org/axis/java}org.foo.Bar
+ public static final String NS_URI_JAVA = "http://xml.apache.org/axis/java";
+
+
+ //
+ // SOAP-ENV Namespaces
+ //
+ public static final String URI_SOAP11_ENV =
+ "http://schemas.xmlsoap.org/soap/envelope/" ;
+ public static final String URI_SOAP12_ENV =
+ "http://www.w3.org/2003/05/soap-envelope";
+
+ // fixme: this is unsafe - a client can (accidentaly or on purpose)
+ // over-write the elemnts of this array. This pattern is used throughout
+ // this file.
+ public static final String[] URIS_SOAP_ENV = {
+ URI_SOAP11_ENV,
+ URI_SOAP12_ENV,
+ };
+
+ // Constant name of the enterprise-style logging category.
+ // The enterprise category is for stuff that an enterprise product might
+ // want to track, but in a simple environment (like the AXIS build) would
+ // be nothing more than a nuisance.
+ public static final String ENTERPRISE_LOG_CATEGORY = "org.apache.axis.enterprise";
+
+ /**
+ * Time logged stuff.
+ */
+ public static final String TIME_LOG_CATEGORY = "org.apache.axis.TIME";
+
+ /**
+ * Servlet exceptions. Axis faults are logged at debug level here.
+ */
+ public static final String EXCEPTION_LOG_CATEGORY = "org.apache.axis.EXCEPTIONS";
+
+ /** The name of the field which accepts xsd:any content in Beans. */
+ public static final String ANYCONTENT = "_any";
+ /**
+ * Buffer size for http.
+ */
+ public static final int HTTP_TXR_BUFFER_SIZE = 8 * 1024;
+
+ /** Basic Profile 1.1 compatibility flag */
+ public static final String WSIBP11_COMPAT_PROPERTY = "axis.ws-i.bp11.compatibility";
+
+ /**
+ * Returns true if the string is the SOAP_ENV namespace.
+ *
+ * @param s the string representation of a URI
+ * @return Returns <code>true</code> if s represents any of the supported soap
+ * envelope URI strings,false otherwise.
+ */
+ public static boolean isSOAP_ENV(String s) {
+ for (int i=0; i<URIS_SOAP_ENV.length; i++) {
+ if (URIS_SOAP_ENV[i].equals(s)) {
+ return true;
+ }
+ }
+ return false;
+ }
+
+
+ public static final String URI_LITERAL_ENC = "";
+
+ //
+ // SOAP-ENC Namespaces
+ //
+ public static final String URI_SOAP11_ENC =
+ "http://schemas.xmlsoap.org/soap/encoding/" ;
+ public static final String URI_SOAP12_ENC =
+ "http://www.w3.org/2003/05/soap-encoding";
+ public static final String URI_SOAP12_NOENC =
+ "http://www.w3.org/2003/05/soap-envelope/encoding/none";
+
+ public static final String[] URIS_SOAP_ENC = {
+ URI_SOAP12_ENC,
+ URI_SOAP11_ENC,
+ };
+
+ /**
+ * Returns true if SOAP_ENC namespace.
+ *
+ * @param s a string representing the URI to check
+ * @return Returns true if <code>s</code> matches a SOAP ENCODING namespace URI,
+ * false otherwise.
+ */
+ public static boolean isSOAP_ENC(String s) {
+ for (int i=0; i<URIS_SOAP_ENC.length; i++) {
+ if (URIS_SOAP_ENC[i].equals(s)) {
+ return true;
+ }
+ }
+ return false;
+ }
+
+ /**
+ * Returns the value of an attribute which might be in one of several namespaces.
+ *
+ * @param attributes the attributes to search.
+ * @param search an array of namespace URI strings to search.
+ * @param localPart is the local part of the attribute name.
+ * @return Returns the value of the attribute or null.
+ */
+ public static String getValue(Attributes attributes,
+ String [] search,
+ String localPart) {
+ if (attributes == null || search == null || localPart == null) {
+ return null;
+ }
+
+ int len = attributes.getLength();
+
+ if (len == 0) {
+ return null;
+ }
+
+ for (int i=0; i < len; i++) {
+ if (attributes.getLocalName(i).equals(localPart)) {
+ String uri = attributes.getURI(i);
+ for (int j=0; j<search.length; j++) {
+ if (search[j].equals(uri)) return attributes.getValue(i);
+ }
+ }
+ }
+
+ return null;
+ }
+
+ /**
+ * Searches an attribute collection for a list of QNames, returning
+ * the value of the first one found, or null if none were found.
+ *
+ * @param attributes
+ * @param search
+ * @return Returns the value of the attribute.
+ */
+ public static String getValue(Attributes attributes,
+ QName [] search) {
+ if (attributes == null || search == null)
+ return null;
+
+ if (attributes.getLength() == 0) return null;
+
+ String value = null;
+ for (int i=0; (value == null) && (i < search.length); i++) {
+ value = attributes.getValue(search[i].getNamespaceURI(),
+ search[i].getLocalPart());
+ }
+
+ return value;
+ }
+
+ /**
+ * The first QName is the current version of the name. The second qname is compared
+ * with the first considering all namespace uri versions.
+ * @param first Currently supported QName.
+ * @param second any qname.
+ * @return Returns true if the qnames represent the same qname (paster namespace uri versions considered).
+ */
+ public static boolean equals(QName first, QName second) {
+ if (first == second) {
+ return true;
+ }
+ if (first==null || second==null) {
+ return false;
+ }
+ if (first.equals(second)) {
+ return true;
+ }
+ if (!first.getLocalPart().equals(second.getLocalPart())) {
+ return false;
+ }
+
+ String namespaceURI = first.getNamespaceURI();
+ String[] search = null;
+ if (namespaceURI.equals(URI_DEFAULT_SCHEMA_XSD))
+ search = URIS_SCHEMA_XSD;
+ else if (namespaceURI.equals(URI_DEFAULT_SCHEMA_XSI))
+ search = URIS_SCHEMA_XSI;
+ else
+ search = new String[] {namespaceURI};
+
+ for (int i=0; i < search.length; i++) {
+ if (search[i].equals(second.getNamespaceURI())) {
+ return true;
+ }
+ }
+ return false;
+ }
+
+ // Misc SOAP Namespaces / URIs
+ public static final String URI_SOAP11_NEXT_ACTOR =
+ "http://schemas.xmlsoap.org/soap/actor/next" ;
+ public static final String URI_SOAP12_NEXT_ROLE =
+ "http://www.w3.org/2003/05/soap-envelope/role/next";
+ /** @deprecated use URI_SOAP12_NEXT_ROLE */
+ public static final String URI_SOAP12_NEXT_ACTOR = URI_SOAP12_NEXT_ROLE;
+
+ public static final String URI_SOAP12_RPC =
+ "http://www.w3.org/2003/05/soap-rpc";
+
+ public static final String URI_SOAP12_NONE_ROLE =
+ "http://www.w3.org/2003/05/soap-envelope/role/none";
+ public static final String URI_SOAP12_ULTIMATE_ROLE =
+ "http://www.w3.org/2003/05/soap-envelope/role/ultimateReceiver";
+
+ public static final String URI_SOAP11_HTTP =
+ "http://schemas.xmlsoap.org/soap/http";
+ public static final String URI_SOAP12_HTTP =
+ "http://www.w3.org/2003/05/http";
+
+ public static final String NS_URI_XMLNS =
+ "http://www.w3.org/2000/xmlns/";
+
+ public static final String NS_URI_XML =
+ "http://www.w3.org/XML/1998/namespace";
+
+ //
+ // Schema XSD Namespaces
+ //
+ public static final String URI_1999_SCHEMA_XSD =
+ "http://www.w3.org/1999/XMLSchema";
+ public static final String URI_2000_SCHEMA_XSD =
+ "http://www.w3.org/2000/10/XMLSchema";
+ public static final String URI_2001_SCHEMA_XSD =
+ "http://www.w3.org/2001/XMLSchema";
+
+ public static final String URI_DEFAULT_SCHEMA_XSD = URI_2001_SCHEMA_XSD;
+
+ public static final String[] URIS_SCHEMA_XSD = {
+ URI_1999_SCHEMA_XSD,
+ URI_2000_SCHEMA_XSD,
+ URI_2001_SCHEMA_XSD
+ };
+
+
+ /**
+ * Returns true if SchemaXSD namespace.
+ *
+ * @param s the string representing the URI to check
+ * @return Returns true if s represents the Schema XSD namespace, false otherwise.
+ */
+ public static boolean isSchemaXSD(String s) {
+ for (int i=0; i<URIS_SCHEMA_XSD.length; i++) {
+ if (URIS_SCHEMA_XSD[i].equals(s)) {
+ return true;
+ }
+ }
+ return false;
+ }
+
+ //
+ // Schema XSI Namespaces
+ //
+ public static final String URI_1999_SCHEMA_XSI =
+ "http://www.w3.org/1999/XMLSchema-instance";
+ public static final String URI_2000_SCHEMA_XSI =
+ "http://www.w3.org/2000/10/XMLSchema-instance";
+ public static final String URI_2001_SCHEMA_XSI =
+ "http://www.w3.org/2001/XMLSchema-instance";
+ public static final String URI_DEFAULT_SCHEMA_XSI = URI_2001_SCHEMA_XSI;
+
+ public static final String[] URIS_SCHEMA_XSI = {
+ URI_1999_SCHEMA_XSI,
+ URI_2000_SCHEMA_XSI,
+ URI_2001_SCHEMA_XSI,
+ };
+
+ /**
+ * Returns true if SchemaXSI namespace.
+ *
+ * @param s the string of the URI to check.
+ * @return Returns true if <code>s</code> is a Schema XSI URI, false otherwise.
+ */
+ public static boolean isSchemaXSI(String s) {
+ for (int i=0; i<URIS_SCHEMA_XSI.length; i++) {
+ if (URIS_SCHEMA_XSI[i].equals(s)) {
+ return true;
+ }
+ }
+ return false;
+ }
+
+ /**
+ * WSDL namespace.
+ */
+ public static final String NS_URI_WSDL11 =
+ "http://schemas.xmlsoap.org/wsdl/";
+
+ public static final String[] NS_URIS_WSDL = {
+ NS_URI_WSDL11,
+ };
+
+ /**
+ * Returns true if this is a WSDL namespace.
+ *
+ * @param s a string of a URI to check.
+ * @return Returns true if <code>s</code> is a WSDL namespace URI, false otherwise
+ */
+ public static boolean isWSDL(String s) {
+ for (int i=0; i<NS_URIS_WSDL.length; i++) {
+ if (NS_URIS_WSDL[i].equals(s)) {
+ return true;
+ }
+ }
+ return false;
+ }
+
+ //
+ // WSDL extensions for SOAP in DIME
+ // (http://gotdotnet.com/team/xml_wsspecs/dime/WSDL-Extension-for-DIME.htm)
+ //
+ public static final String URI_DIME_WSDL =
+ "http://schemas.xmlsoap.org/ws/2002/04/dime/wsdl/";
+
+ public static final String URI_DIME_CONTENT =
+ "http://schemas.xmlsoap.org/ws/2002/04/content-type/";
+
+ public static final String URI_DIME_REFERENCE=
+ "http://schemas.xmlsoap.org/ws/2002/04/reference/";
+
+ public static final String URI_DIME_CLOSED_LAYOUT=
+ "http://schemas.xmlsoap.org/ws/2002/04/dime/closed-layout";
+
+ public static final String URI_DIME_OPEN_LAYOUT=
+ "http://schemas.xmlsoap.org/ws/2002/04/dime/open-layout";
+
+ //
+ // WSDL SOAP namespace
+ //
+ public static final String URI_WSDL11_SOAP =
+ "http://schemas.xmlsoap.org/wsdl/soap/";
+ public static final String URI_WSDL12_SOAP =
+ "http://schemas.xmlsoap.org/wsdl/soap12/";
+
+ public static final String[] NS_URIS_WSDL_SOAP = {
+ URI_WSDL11_SOAP,
+ URI_WSDL12_SOAP
+ };
+
+ /**
+ * Returns true if s is a WSDL SOAP namespace.
+ *
+ * @param s a string of a URI to check.
+ * @return Returns true if <code>s</code> matches any of the WSDL SOAP namepace
+ * URIs, false otherwise.
+ */
+ public static boolean isWSDLSOAP(String s) {
+ for (int i=0; i<NS_URIS_WSDL_SOAP.length; i++) {
+ if (NS_URIS_WSDL_SOAP[i].equals(s)) {
+ return true;
+ }
+ }
+ return false;
+ }
+
+ // Axis Mechanism Type
+ public static final String AXIS_SAX = "Axis SAX Mechanism";
+
+ public static final String ELEM_ENVELOPE = "Envelope" ;
+ public static final String ELEM_HEADER = "Header" ;
+ public static final String ELEM_BODY = "Body" ;
+ public static final String ELEM_FAULT = "Fault" ;
+
+ public static final String ELEM_NOTUNDERSTOOD = "NotUnderstood";
+ public static final String ELEM_UPGRADE = "Upgrade";
+ public static final String ELEM_SUPPORTEDENVELOPE = "SupportedEnvelope";
+
+ public static final String ELEM_FAULT_CODE = "faultcode" ;
+ public static final String ELEM_FAULT_STRING = "faultstring" ;
+ public static final String ELEM_FAULT_DETAIL = "detail" ;
+ public static final String ELEM_FAULT_ACTOR = "faultactor" ;
+
+ public static final String ELEM_FAULT_CODE_SOAP12 = "Code" ;
+ public static final String ELEM_FAULT_VALUE_SOAP12 = "Value" ;
+ public static final String ELEM_FAULT_SUBCODE_SOAP12 = "Subcode" ;
+ public static final String ELEM_FAULT_REASON_SOAP12 = "Reason" ;
+ public static final String ELEM_FAULT_NODE_SOAP12 = "Node" ;
+ public static final String ELEM_FAULT_ROLE_SOAP12 = "Role" ;
+ public static final String ELEM_FAULT_DETAIL_SOAP12 = "Detail" ;
+ public static final String ELEM_TEXT_SOAP12 = "Text" ;
+
+ public static final String ATTR_MUST_UNDERSTAND = "mustUnderstand" ;
+ public static final String ATTR_ENCODING_STYLE = "encodingStyle" ;
+ public static final String ATTR_ACTOR = "actor" ;
+ public static final String ATTR_ROLE = "role" ;
+ public static final String ATTR_RELAY = "relay" ;
+ public static final String ATTR_ROOT = "root" ;
+ public static final String ATTR_ID = "id" ;
+ public static final String ATTR_HREF = "href" ;
+ public static final String ATTR_REF = "ref" ;
+ public static final String ATTR_QNAME = "qname";
+ public static final String ATTR_ARRAY_TYPE = "arrayType";
+ public static final String ATTR_ITEM_TYPE = "itemType";
+ public static final String ATTR_ARRAY_SIZE = "arraySize";
+ public static final String ATTR_OFFSET = "offset";
+ public static final String ATTR_POSITION = "position";
+ public static final String ATTR_TYPE = "type";
+ public static final String ATTR_HANDLERINFOCHAIN = "handlerInfoChain";
+
+ // Fault Codes
+ //////////////////////////////////////////////////////////////////////////
+ public static final String FAULT_CLIENT = "Client";
+
+ public static final String FAULT_SERVER_GENERAL =
+ "Server.generalException";
+
+ public static final String FAULT_SERVER_USER =
+ "Server.userException";
+
+ public static final QName FAULT_VERSIONMISMATCH =
+ new QName(URI_SOAP11_ENV, "VersionMismatch");
+
+ public static final QName FAULT_MUSTUNDERSTAND =
+ new QName(URI_SOAP11_ENV, "MustUnderstand");
+
+
+ public static final QName FAULT_SOAP12_MUSTUNDERSTAND =
+ new QName(URI_SOAP12_ENV, "MustUnderstand");
+
+ public static final QName FAULT_SOAP12_VERSIONMISMATCH =
+ new QName(URI_SOAP12_ENV, "VersionMismatch");
+
+ public static final QName FAULT_SOAP12_DATAENCODINGUNKNOWN =
+ new QName(URI_SOAP12_ENV, "DataEncodingUnknown");
+
+ public static final QName FAULT_SOAP12_SENDER =
+ new QName(URI_SOAP12_ENV, "Sender");
+
+ public static final QName FAULT_SOAP12_RECEIVER =
+ new QName(URI_SOAP12_ENV, "Receiver");
+
+ // SOAP 1.2 Fault subcodes
+ public static final QName FAULT_SUBCODE_BADARGS =
+ new QName(URI_SOAP12_RPC, "BadArguments");
+ public static final QName FAULT_SUBCODE_PROC_NOT_PRESENT =
+ new QName(URI_SOAP12_RPC, "ProcedureNotPresent");
+
+ // QNames
+ //////////////////////////////////////////////////////////////////////////
+ public static final QName QNAME_FAULTCODE =
+ new QName("", ELEM_FAULT_CODE);
+ public static final QName QNAME_FAULTSTRING =
+ new QName("", ELEM_FAULT_STRING);
+ public static final QName QNAME_FAULTACTOR =
+ new QName("", ELEM_FAULT_ACTOR);
+ public static final QName QNAME_FAULTDETAILS =
+ new QName("", ELEM_FAULT_DETAIL);
+
+ public static final QName QNAME_FAULTCODE_SOAP12 =
+ new QName(URI_SOAP12_ENV, ELEM_FAULT_CODE_SOAP12);
+ public static final QName QNAME_FAULTVALUE_SOAP12 =
+ new QName(URI_SOAP12_ENV, ELEM_FAULT_VALUE_SOAP12);
+ public static final QName QNAME_FAULTSUBCODE_SOAP12 =
+ new QName(URI_SOAP12_ENV, ELEM_FAULT_SUBCODE_SOAP12);
+ public static final QName QNAME_FAULTREASON_SOAP12 =
+ new QName(URI_SOAP12_ENV, ELEM_FAULT_REASON_SOAP12);
+ public static final QName QNAME_TEXT_SOAP12 =
+ new QName(URI_SOAP12_ENV, ELEM_TEXT_SOAP12);
+
+ public static final QName QNAME_FAULTNODE_SOAP12 =
+ new QName(URI_SOAP12_ENV, ELEM_FAULT_NODE_SOAP12);
+ public static final QName QNAME_FAULTROLE_SOAP12 =
+ new QName(URI_SOAP12_ENV, ELEM_FAULT_ROLE_SOAP12);
+ public static final QName QNAME_FAULTDETAIL_SOAP12 =
+ new QName(URI_SOAP12_ENV, ELEM_FAULT_DETAIL_SOAP12);
+ public static final QName QNAME_NOTUNDERSTOOD =
+ new QName(URI_SOAP12_ENV, ELEM_NOTUNDERSTOOD);
+
+ // Define qnames for the all of the XSD and SOAP-ENC encodings
+ public static final QName XSD_STRING = new QName(URI_DEFAULT_SCHEMA_XSD, "string");
+ public static final QName XSD_BOOLEAN = new QName(URI_DEFAULT_SCHEMA_XSD, "boolean");
+ public static final QName XSD_DOUBLE = new QName(URI_DEFAULT_SCHEMA_XSD, "double");
+ public static final QName XSD_FLOAT = new QName(URI_DEFAULT_SCHEMA_XSD, "float");
+ public static final QName XSD_INT = new QName(URI_DEFAULT_SCHEMA_XSD, "int");
+ public static final QName XSD_INTEGER = new QName(URI_DEFAULT_SCHEMA_XSD, "integer");
+ public static final QName XSD_LONG = new QName(URI_DEFAULT_SCHEMA_XSD, "long");
+ public static final QName XSD_SHORT = new QName(URI_DEFAULT_SCHEMA_XSD, "short");
+ public static final QName XSD_BYTE = new QName(URI_DEFAULT_SCHEMA_XSD, "byte");
+ public static final QName XSD_DECIMAL = new QName(URI_DEFAULT_SCHEMA_XSD, "decimal");
+ public static final QName XSD_BASE64 = new QName(URI_DEFAULT_SCHEMA_XSD, "base64Binary");
+ public static final QName XSD_HEXBIN = new QName(URI_DEFAULT_SCHEMA_XSD, "hexBinary");
+ public static final QName XSD_ANYSIMPLETYPE = new QName(URI_DEFAULT_SCHEMA_XSD, "anySimpleType");
+ public static final QName XSD_ANYTYPE = new QName(URI_DEFAULT_SCHEMA_XSD, "anyType");
+ public static final QName XSD_ANY = new QName(URI_DEFAULT_SCHEMA_XSD, "any");
+ public static final QName XSD_QNAME = new QName(URI_DEFAULT_SCHEMA_XSD, "QName");
+ public static final QName XSD_DATETIME = new QName(URI_DEFAULT_SCHEMA_XSD, "dateTime");
+ public static final QName XSD_DATE = new QName(URI_DEFAULT_SCHEMA_XSD, "date");
+ public static final QName XSD_TIME = new QName(URI_DEFAULT_SCHEMA_XSD, "time");
+ public static final QName XSD_TIMEINSTANT1999 = new QName(URI_1999_SCHEMA_XSD, "timeInstant");
+ public static final QName XSD_TIMEINSTANT2000 = new QName(URI_2000_SCHEMA_XSD, "timeInstant");
+
+ public static final QName XSD_NORMALIZEDSTRING = new QName(URI_2001_SCHEMA_XSD, "normalizedString");
+ public static final QName XSD_TOKEN = new QName(URI_2001_SCHEMA_XSD, "token");
+
+ public static final QName XSD_UNSIGNEDLONG = new QName(URI_2001_SCHEMA_XSD, "unsignedLong");
+ public static final QName XSD_UNSIGNEDINT = new QName(URI_2001_SCHEMA_XSD, "unsignedInt");
+ public static final QName XSD_UNSIGNEDSHORT = new QName(URI_2001_SCHEMA_XSD, "unsignedShort");
+ public static final QName XSD_UNSIGNEDBYTE = new QName(URI_2001_SCHEMA_XSD, "unsignedByte");
+ public static final QName XSD_POSITIVEINTEGER = new QName(URI_2001_SCHEMA_XSD, "positiveInteger");
+ public static final QName XSD_NEGATIVEINTEGER = new QName(URI_2001_SCHEMA_XSD, "negativeInteger");
+ public static final QName XSD_NONNEGATIVEINTEGER = new QName(URI_2001_SCHEMA_XSD, "nonNegativeInteger");
+ public static final QName XSD_NONPOSITIVEINTEGER = new QName(URI_2001_SCHEMA_XSD, "nonPositiveInteger");
+
+ public static final QName XSD_YEARMONTH = new QName(URI_2001_SCHEMA_XSD, "gYearMonth");
+ public static final QName XSD_MONTHDAY = new QName(URI_2001_SCHEMA_XSD, "gMonthDay");
+ public static final QName XSD_YEAR = new QName(URI_2001_SCHEMA_XSD, "gYear");
+ public static final QName XSD_MONTH = new QName(URI_2001_SCHEMA_XSD, "gMonth");
+ public static final QName XSD_DAY = new QName(URI_2001_SCHEMA_XSD, "gDay");
+ public static final QName XSD_DURATION = new QName(URI_2001_SCHEMA_XSD, "duration");
+
+ public static final QName XSD_NAME = new QName(URI_2001_SCHEMA_XSD, "Name");
+ public static final QName XSD_NCNAME = new QName(URI_2001_SCHEMA_XSD, "NCName");
+ public static final QName XSD_NMTOKEN = new QName(URI_2001_SCHEMA_XSD, "NMTOKEN");
+ public static final QName XSD_NMTOKENS = new QName(URI_2001_SCHEMA_XSD, "NMTOKENS");
+ public static final QName XSD_NOTATION = new QName(URI_2001_SCHEMA_XSD, "NOTATION");
+ public static final QName XSD_ENTITY = new QName(URI_2001_SCHEMA_XSD, "ENTITY");
+ public static final QName XSD_ENTITIES = new QName(URI_2001_SCHEMA_XSD, "ENTITIES");
+ public static final QName XSD_IDREF = new QName(URI_2001_SCHEMA_XSD, "IDREF");
+ public static final QName XSD_IDREFS = new QName(URI_2001_SCHEMA_XSD, "IDREFS");
+ public static final QName XSD_ANYURI = new QName(URI_2001_SCHEMA_XSD, "anyURI");
+ public static final QName XSD_LANGUAGE = new QName(URI_2001_SCHEMA_XSD, "language");
+ public static final QName XSD_ID = new QName(URI_2001_SCHEMA_XSD, "ID");
+ public static final QName XSD_SCHEMA = new QName(URI_2001_SCHEMA_XSD, "schema");
+
+ public static final QName XML_LANG = new QName(NS_URI_XML, "lang");
+
+
+ public static final QName SOAP_COMMON_ATTRS11 = new QName(URI_SOAP11_ENC, "commonAttributes");
+ public static final QName SOAP_COMMON_ATTRS12 = new QName(URI_SOAP12_ENC, "commonAttributes");
+ public static final QName SOAP_ARRAY_ATTRS11 = new QName(URI_SOAP11_ENC, "arrayAttributes");
+ public static final QName SOAP_ARRAY_ATTRS12 = new QName(URI_SOAP12_ENC, "arrayAttributes");
+ public static final QName SOAP_ARRAY12 = new QName(URI_SOAP12_ENC, "Array");
+
+ public static final QName SOAP_MAP = new QName(NS_URI_XMLSOAP, "Map");
+ public static final QName SOAP_ELEMENT = new QName(NS_URI_XMLSOAP, "Element");
+ public static final QName SOAP_DOCUMENT = new QName(NS_URI_XMLSOAP, "Document");
+ public static final QName SOAP_VECTOR = new QName(NS_URI_XMLSOAP, "Vector");
+ public static final QName MIME_IMAGE = new QName(NS_URI_XMLSOAP, "Image");
+ public static final QName MIME_PLAINTEXT = new QName(NS_URI_XMLSOAP, "PlainText");
+ public static final QName MIME_MULTIPART = new QName(NS_URI_XMLSOAP, "Multipart");
+ public static final QName MIME_SOURCE = new QName(NS_URI_XMLSOAP, "Source");
+ public static final QName MIME_OCTETSTREAM = new QName(NS_URI_XMLSOAP, "octet-stream");
+ public static final QName MIME_DATA_HANDLER = new QName(NS_URI_XMLSOAP, "DataHandler");
+
+
+ public static final QName QNAME_LITERAL_ITEM = new QName(URI_LITERAL_ENC,"item");
+ public static final QName QNAME_RPC_RESULT = new QName(URI_SOAP12_RPC,"result");
+
+ /**
+ * QName of stack trace element in an axis fault detail.
+ */
+ public static final QName QNAME_FAULTDETAIL_STACKTRACE = new QName(NS_URI_AXIS,"stackTrace");
+
+ /**
+ * QName of exception name element in an axis fault detail.
+ * Do not use - this is for pre-1.0 server->client exceptions.
+ */
+ public static final QName QNAME_FAULTDETAIL_EXCEPTIONNAME = new QName(NS_URI_AXIS, "exceptionName");
+
+ /**
+ * Flag set if this was a runtime exception, rather than something thrown by the class at the end of the
+ * chain. Axis' logging treats runtime exceptions more seriously.
+ */
+ public static final QName QNAME_FAULTDETAIL_RUNTIMEEXCEPTION = new QName(NS_URI_AXIS, "isRuntimeException");
+
+ /**
+ * QName of HTTP Error code element in an axis fault detail.
+ */
+ public static final QName QNAME_FAULTDETAIL_HTTPERRORCODE = new QName(NS_URI_AXIS, "HttpErrorCode");
+
+ /**
+ * QName of a nested fault in an axis fault detail.
+ */
+ public static final QName QNAME_FAULTDETAIL_NESTEDFAULT = new QName(NS_URI_AXIS, "nestedFault");
+
+ /**
+ * QName of a hostname in an axis fault detail.
+ */
+ public static final QName QNAME_FAULTDETAIL_HOSTNAME = new QName(NS_URI_AXIS, "hostname");
+
+ //QNames of well known faults
+ /**
+ * The no-service fault value.
+ */
+ public static final QName QNAME_NO_SERVICE_FAULT_CODE
+ = new QName(NS_URI_AXIS, "Server.NoService");
+
+ // Misc Strings
+ //////////////////////////////////////////////////////////////////////////
+
+ // Where to put those pesky JWS classes
+ public static final String MC_JWS_CLASSDIR = "jws.classDir" ;
+ // Where we're rooted
+ public static final String MC_HOME_DIR = "home.dir";
+
+ // Relative path of the request URL (ie. http://.../axis/a.jws = /a.jws
+ public static final String MC_RELATIVE_PATH = "path";
+
+ // MessageContext param for the engine's path
+ public static final String MC_REALPATH = "realpath";
+ // MessageContext param for the location of config files
+ public static final String MC_CONFIGPATH = "configPath";
+ // MessageContext param for the IP of the calling client
+ public static final String MC_REMOTE_ADDR = "remoteaddr";
+ // When invoked from a servlet, per JAX-RPC, we need a
+ // ServletEndpointContext object. This is where it lives.
+ public static final String MC_SERVLET_ENDPOINT_CONTEXT = "servletEndpointContext";
+
+ // If we're SOAP 1.2, the default behavior in org.apache.axis.message.BodyBuilder
+ // is to throw a ProcedureNotPresent fault if we can't dispatch to an
+ // OperationDesc during deserialization. Set this property to any non-null
+ // value to prevent this behavior (only used by test.soap12.
+ public static final String MC_NO_OPERATION_OK = "NoOperationOK";
+
+ // This property indicates we're supporting only a single SOAP version.
+ // If set (by the service or engine), we'll only accept envelopes of the
+ // specified version. Value should be an org.apache.axis.soap.SOAPConstants
+ public static final String MC_SINGLE_SOAP_VERSION = "SingleSOAPVersion";
+
+ /**
+ * What the extension of JWS files is. If changing this, note that
+ * AxisServlet has an xdoclet declaration in the class javadocs that
+ * also needs updating.
+ */
+ public static final String JWS_DEFAULT_FILE_EXTENSION = ".jws";
+
+ /**
+ * The default timeout for messages.
+ *
+ * @since Axis1.2
+ */
+ public static final int DEFAULT_MESSAGE_TIMEOUT=60*1000*10;
+
+ /**
+ * MIME Content Types.
+ *
+ * @since Axis1.2
+ */
+ public static final String MIME_CT_APPLICATION_OCTETSTREAM = "application/octet-stream";
+ public static final String MIME_CT_TEXT_PLAIN = "text/plain";
+ public static final String MIME_CT_IMAGE_JPEG = "image/jpeg";
+ public static final String MIME_CT_IMAGE_GIF = "image/gif";
+ public static final String MIME_CT_TEXT_XML = "text/xml";
+ public static final String MIME_CT_APPLICATION_XML = "application/xml";
+ public static final String MIME_CT_MULTIPART_PREFIX = "multipart/";
+}
Modified: webservices/axis2/trunk/java/modules/codegen/src/org/apache/axis2/databinding/Holder.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/codegen/src/org/apache/axis2/databinding/Holder.java?rev=349758&r1=349757&r2=349758&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/codegen/src/org/apache/axis2/databinding/Holder.java (original)
+++ webservices/axis2/trunk/java/modules/codegen/src/org/apache/axis2/databinding/Holder.java Tue Nov 29 08:53:03 2005
@@ -17,7 +17,7 @@
package org.apache.axis2.databinding;
/**
- * Holder
+ * Interface Holder
*/
public interface Holder {
}
Modified: webservices/axis2/trunk/java/modules/codegen/src/org/apache/axis2/databinding/MultiTarget.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/codegen/src/org/apache/axis2/databinding/MultiTarget.java?rev=349758&r1=349757&r2=349758&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/codegen/src/org/apache/axis2/databinding/MultiTarget.java (original)
+++ webservices/axis2/trunk/java/modules/codegen/src/org/apache/axis2/databinding/MultiTarget.java Tue Nov 29 08:53:03 2005
@@ -21,14 +21,14 @@
/**
* A MultiTarget aggregates a bunch of targets into a single one.
- * This is used when multiple targets are waiting for a single SOAP
- * multiref deserialization, for instance.
+ * This is used, for instance, when multiple targets are waiting for a single SOAP
+ * multiref deserialization.
*/
public class MultiTarget implements DeserializationTarget {
ArrayList targets = new ArrayList();
/**
- * Add a target to the list of targets which will be updated when
+ * Adds a target to the list of targets which will be updated when
* we receive a value.
*
* @param target
Modified: webservices/axis2/trunk/java/modules/codegen/src/org/apache/axis2/databinding/SerializationContext.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/codegen/src/org/apache/axis2/databinding/SerializationContext.java?rev=349758&r1=349757&r2=349758&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/codegen/src/org/apache/axis2/databinding/SerializationContext.java (original)
+++ webservices/axis2/trunk/java/modules/codegen/src/org/apache/axis2/databinding/SerializationContext.java Tue Nov 29 08:53:03 2005
@@ -146,12 +146,12 @@
}
/**
- * Obtain an ID for this object, which will be written (according to the
+ * Obtains an ID for this object, which will be written (according to the
* SOAP 1.1 multiref rules) as an independent element at the end of the
- * SOAP body - see finish()).
+ * SOAP body
*
* @param obj
- * @return an ID, always. Either a new one or a previously registered one.
+ * @return Returns an ID, always - either a new one or a previously registered one.
*/
public String getSOAP11IDForObject(Object obj, Serializer serializer) {
if (multirefObjects != null) {
Modified: webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/deployment/DeploymentEngine.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/deployment/DeploymentEngine.java?rev=349758&r1=349757&r2=349758&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/deployment/DeploymentEngine.java (original)
+++ webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/deployment/DeploymentEngine.java Tue Nov 29 08:53:03 2005
@@ -370,7 +370,7 @@
serviceGroup.setParent(axisConfig);
//engaging globally engage module to this service group
Iterator itr_global_modules =
- ((AxisConfigurationImpl) axisConfig).getEngadgedModules().iterator();
+ ((AxisConfigurationImpl) axisConfig).getEngagedModules().iterator();
while (itr_global_modules.hasNext()) {
QName qName = (QName) itr_global_modules.next();
serviceGroup.engageModuleToGroup(qName);
Modified: webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AbstractDispatcher.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AbstractDispatcher.java?rev=349758&r1=349757&r2=349758&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AbstractDispatcher.java (original)
+++ webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AbstractDispatcher.java Tue Nov 29 08:53:03 2005
@@ -26,11 +26,11 @@
import javax.xml.namespace.QName;
/**
- * This the base class for all dispatchers, it is a Handler which has a one
- * traget, that is to find the Service a given SOAP message is targeted to.
+ * This the base class for all dispatchers. A dispatcher's task is
+ * to find the service for an incoming SOAP message.
* <p/>
- * Axis2 service dispatching is model via a Chain of diapatchers, each trying to
- * Diaptach but let go without throwing a execption in case they fail.
+ * In Axis2, a chain of dispatchers is setup. Each tries to
+ * dispatch and returns without throwing an exception, in case, it fails.
*/
public abstract class AbstractDispatcher extends AbstractHandler {
/**
@@ -53,8 +53,7 @@
public abstract void initDispatcher();
/**
- * This is final, obivously not for overiding
- *
+ *
* @param msgctx
* @throws org.apache.axis2.AxisFault
*/
@@ -96,21 +95,21 @@
}
/**
- * Give the diaptacher turn to find the Service
+ * Called by Axis Engine to find the service.
*
* @param messageContext
- * @return
+ * @return Returns AxisService.
* @throws AxisFault
*/
public abstract AxisService findService(
MessageContext messageContext) throws AxisFault;
/**
- * Give the diaptacher turn to find the Operation
+ * Called by Axis Engine to find the operation.
*
* @param service
* @param messageContext
- * @return
+ * @return Returns AxisOperation.
* @throws AxisFault
*/
public abstract AxisOperation findOperation(
Modified: webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AddressingBasedDispatcher.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AddressingBasedDispatcher.java?rev=349758&r1=349757&r2=349758&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AddressingBasedDispatcher.java (original)
+++ webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AddressingBasedDispatcher.java Tue Nov 29 08:53:03 2005
@@ -28,7 +28,7 @@
import javax.xml.namespace.QName;
/**
- * Dispatcher based on the WS-Addressing properties
+ * Dispatcher based on the WS-Addressing properties.
*/
public class AddressingBasedDispatcher extends AbstractDispatcher implements AddressingConstants {
/**
Modified: webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AxisConfiguration.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AxisConfiguration.java?rev=349758&r1=349757&r2=349758&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AxisConfiguration.java (original)
+++ webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AxisConfiguration.java Tue Nov 29 08:53:03 2005
@@ -31,7 +31,7 @@
import java.util.Iterator;
/**
- * The palce where all the Global states of Axis is kept.
+ * The place where all the Global states of Axis is kept.
* All the Global states kept in the <code>EngineRegistry</code> and all the
* Service states kept in the <code>MessageContext</code>. Other runtime
* artifacts does not keep states foward from the execution.
@@ -55,16 +55,16 @@
public static final int FAULT_OUT_FLOW = 10006;
/**
- * Method getService
+ * Method getService.
*
* @param name
- * @return
+ * @return Returns AxisService.
* @throws AxisFault
*/
public AxisService getService(String name) throws AxisFault;
/**
- * Method addService
+ * Method addService.
*
* @param service
* @throws AxisFault
@@ -75,7 +75,7 @@
public void addServiceGroup(AxisServiceGroup axisServiceGroup) throws AxisFault;
/**
- * Method removeService
+ * Method removeService.
*
* @param name
* @throws AxisFault
@@ -83,14 +83,15 @@
public void removeService(String name) throws AxisFault;
/**
- * Modules is read only as they can not deployed while runing
+ * Modules is read only as they can not deployed while running.
*
* @param name
+ * @return Returns ModuleDescription.
*/
public ModuleDescription getModule(QName name);
/**
- * Method addMdoule
+ * Method addMdoule.
*
* @param module
* @throws AxisFault
@@ -100,7 +101,7 @@
public boolean isEngaged(QName moduleName);
/**
- * To engage a module at the run time it can be used this method
+ * Engages a module at run time.
*
* @param moduleref
* @throws AxisFault
@@ -112,7 +113,7 @@
public HashMap getServices();
/**
- * This returns
+ *
*/
public ArrayList getInPhasesUptoAndIncludingPostDispatch();
@@ -134,8 +135,8 @@
public HashMap getTransportsOut();
- //to check whether a given paramter is locked
- public boolean isParameterLocked(String paramterName);
+ //Checks whether a given parameter is locked.
+ public boolean isParameterLocked(String parameterName);
public AxisServiceGroup getServiceGroup(String serviceNameAndGroupString);
Modified: webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AxisConfigurationImpl.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AxisConfigurationImpl.java?rev=349758&r1=349757&r2=349758&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AxisConfigurationImpl.java (original)
+++ webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AxisConfigurationImpl.java Tue Nov 29 08:53:03 2005
@@ -32,7 +32,7 @@
import java.util.*;
/**
- * Class EngineRegistryImpl
+ * Class AxisConfigurationImpl
*/
public class AxisConfigurationImpl implements AxisConfiguration {
/**
@@ -78,7 +78,7 @@
protected PhasesInfo phasesinfo;
/**
- * Field modules
+ * Field engagedModules
*/
protected final List engagedModules;
@@ -99,7 +99,7 @@
/////////////////////// From AxisGlobal /////////////////////////////////////
/**
- * Constructor EngineRegistryImpl
+ * Constructor AxisConfigurationImpl
*/
public AxisConfigurationImpl() {
moduleConfigmap = new HashMap();
@@ -126,7 +126,7 @@
/**
- * setting the default dispatching order
+ * Sets the default dispatching order.
*/
public void setDefaultDispatchers() {
@@ -169,7 +169,7 @@
/**
- * Setting the custom dispatching order
+ * Sets the custom dispatching order.
*
* @param dispatch
*/
@@ -198,7 +198,7 @@
}
/**
- * Method addMdoule
+ * Method addModule.
*
* @param module
* @throws AxisFault
@@ -209,7 +209,7 @@
}
/**
- * Method addService
+ * Method addService.
*
* @param service
* @throws AxisFault
@@ -248,27 +248,27 @@
}
/**
- * Method getModule
+ * Method getModule.
*
* @param name
- * @return ModuleDescription
+ * @return Returns ModuleDescription.
*/
public ModuleDescription getModule(QName name) {
return (ModuleDescription) modules.get(name);
}
/**
- * @return HashMap
+ * @return Returns HashMap.
*/
public HashMap getModules() {
return modules;
}
/**
- * Method getService
+ * Method getService.
*
* @param name
- * @return
+ * @return Returns AxisService.
* @throws AxisFault
*/
public AxisService getService(String name) throws AxisFault {
@@ -276,7 +276,7 @@
}
/**
- * Method removeService
+ * Method removeService.
*
* @param name
* @throws AxisFault
@@ -293,7 +293,7 @@
}
/**
- * Method addTransport
+ * Method addTransportIn.
*
* @param transport
* @throws AxisFault
@@ -308,7 +308,7 @@
}
/**
- * Method addTransport
+ * Method addTransportOut.
*
* @param transport
* @throws AxisFault
@@ -326,9 +326,14 @@
return transportsOut;
}
- //to check whether a given paramter is locked
- public boolean isParameterLocked(String paramterName) {
- Parameter parameter = getParameter(paramterName);
+ /**
+ * Checks whether a given parameter is locked.
+ *
+ * @param parameterName
+ * @return Returns boolean
+ */
+ public boolean isParameterLocked(String parameterName) {
+ Parameter parameter = getParameter(parameterName);
return parameter != null && parameter.isLocked();
}
@@ -359,14 +364,14 @@
/**
- * @return ArrayList
+ * @return Returns ArrayList
*/
public ArrayList getInFaultFlow() {
return inFaultPhases;
}
/**
- * @return ArrayList
+ * @return Returns ArrayList
*/
public ArrayList getOutFaultFlow() {
return outFaultPhases;
@@ -398,10 +403,10 @@
}
/**
- * Method getParameter
+ * Method getParameter.
*
* @param name
- * @return Parameter
+ * @return Returns Parameter
*/
public Parameter getParameter(String name) {
return paramInclude.getParameter(name);
@@ -412,7 +417,7 @@
}
/**
- * Method addParameter
+ * Method addParameter.
*
* @param param
*/
@@ -425,11 +430,11 @@
}
/**
- * Method getEngadgedModules
+ * Method getEngagedModules.
*
* @return Collection
*/
- public Collection getEngadgedModules() {
+ public Collection getEngagedModules() {
return engagedModules;
}
@@ -552,7 +557,7 @@
/**
- * Adding module configuration , if there is moduleConfig tag in service
+ * Adds module configuration, if there is moduleConfig tag in service.
*
* @param moduleConfiguration
*/
Modified: webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AxisEngine.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AxisEngine.java?rev=349758&r1=349757&r2=349758&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AxisEngine.java (original)
+++ webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AxisEngine.java Tue Nov 29 08:53:03 2005
@@ -154,7 +154,7 @@
}
/**
- * This Method Send the SOAP Fault to a Other SOAP Node
+ * Sends the SOAP Fault to another SOAP node.
*
* @param msgContext
* @throws AxisFault
@@ -183,6 +183,7 @@
/**
* This is invoked when a SOAP Fault is received from a Other SOAP Node
+ * Receives a SOAP fault from another SOAP node.
*
* @param msgContext
* @throws AxisFault
@@ -220,9 +221,9 @@
}
/**
- * If error occurs at inflow or the out flow this method will call to handle the error. But if the
- * execution reach this method twice, means the sending the error handling failed an in that case the
- * this method just log the error and exit</p>
+ * This method is called to handle any error that occurs at inflow or outflow. But if the
+ * method is called twice, it implies that sending the error handling has failed, in which case
+ * the method logs the error and exists.
*
* @param processingContext
* @param e
Modified: webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AxisEvent.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AxisEvent.java?rev=349758&r1=349757&r2=349758&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AxisEvent.java (original)
+++ webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/AxisEvent.java Tue Nov 29 08:53:03 2005
@@ -21,9 +21,8 @@
public class AxisEvent {
/**
- * Axis event will throw when ever some considerable thing happen to
- * <code>AxisConfiguration</code> and registred Listeners will get
- * informed.
+ * An Axis event is sent to registered listeners whenever anything significant
+ * happens to <code>AxisConfiguration</code>.
*/
public static final int SERVICE_DEPLOY = 1;