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/02/20 04:01:03 UTC
svn commit: r154468 [1/6] - in webservices/axis/trunk/java/modules/om/src:
java/org/apache/axis/om/ java/org/apache/axis/om/impl/llom/
java/org/apache/axis/om/impl/llom/builder/
java/org/apache/axis/om/impl/llom/exception/
java/org/apache/axis/om/impl/llom/factory/
java/org/apache/axis/om/impl/llom/serialize/
java/org/apache/axis/om/impl/llom/traverse/ test-resources/
test-resources/badsoap/ test-resources/soap/ test/org/apache/axis/om/
test/org/apache/axis/om/factory/ test/org/apache/axis/om/impl/builder/
test/org/apache/axis/om/impl/serializer/
test/org/apache/axis/om/impl/streamwrapper/
test/org/apache/axis/om/impl/traverse/
Author: dims
Date: Sat Feb 19 19:00:47 2005
New Revision: 154468
URL: http://svn.apache.org/viewcvs?view=rev&rev=154468
Log:
reformatting, cleaning up javadocs, remove commented out code, etc...no logic changes
Modified:
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/FactoryFinder.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMAttribute.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMConstants.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMElement.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMException.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMFactory.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMFactoryException.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMNamedNode.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMNamespace.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMNode.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMSerializer.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMText.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMUtils.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMXMLParserWrapper.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/SOAPBody.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/SOAPEnvelope.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/SOAPFault.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/SOAPHeader.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/SOAPHeaderBlock.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/OMAttributeImpl.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/OMDocument.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/OMElementImpl.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/OMNamedNodeImpl.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/OMNamespaceImpl.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/OMNavigator.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/OMNodeImpl.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/OMStAXWrapper.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/OMTextImpl.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/SOAPBodyImpl.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/SOAPEnvelopeImpl.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/SOAPFaultImpl.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/SOAPHeaderBlockImpl.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/SOAPHeaderImpl.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/builder/StAXBuilder.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/builder/StAXOMBuilder.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/builder/StAXSOAPModelBuilder.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/exception/OMBuilderException.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/exception/OMStreamingException.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/factory/OMLinkedListImplFactory.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/factory/OMXMLBuilderFactory.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/serialize/StreamWriterToContentHandlerConverter.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/serialize/StreamingOMSerializer.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/traverse/OMChildrenIterator.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/traverse/OMChildrenQNameIterator.java
webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/traverse/OMChildrenWithSpecificAttributeIterator.java
webservices/axis/trunk/java/modules/om/src/test-resources/badsoap/bodyNotQualified.xml
webservices/axis/trunk/java/modules/om/src/test-resources/badsoap/envelopeMissing.xml
webservices/axis/trunk/java/modules/om/src/test-resources/badsoap/haederBodyWrongOrder.xml
webservices/axis/trunk/java/modules/om/src/test-resources/badsoap/notnamespaceQualified.xml
webservices/axis/trunk/java/modules/om/src/test-resources/badsoap/twoBodymessage.xml
webservices/axis/trunk/java/modules/om/src/test-resources/badsoap/twoheaders.xml
webservices/axis/trunk/java/modules/om/src/test-resources/badsoap/wrongSoapNs.xml
webservices/axis/trunk/java/modules/om/src/test-resources/non_soap.xml
webservices/axis/trunk/java/modules/om/src/test-resources/soap/emtyBodymessage.xml
webservices/axis/trunk/java/modules/om/src/test-resources/soap/minimalMessage.xml
webservices/axis/trunk/java/modules/om/src/test-resources/soap/reallyReallyBigMessage.xml
webservices/axis/trunk/java/modules/om/src/test-resources/soap/sample1.xml
webservices/axis/trunk/java/modules/om/src/test-resources/soap/security2-soap.xml
webservices/axis/trunk/java/modules/om/src/test-resources/soap/soapmessage.xml
webservices/axis/trunk/java/modules/om/src/test-resources/soap/soapmessage1.xml
webservices/axis/trunk/java/modules/om/src/test-resources/soap/whitespacedMessage.xml
webservices/axis/trunk/java/modules/om/src/test/org/apache/axis/om/AbstractTestCase.java
webservices/axis/trunk/java/modules/om/src/test/org/apache/axis/om/BadInputTest.java
webservices/axis/trunk/java/modules/om/src/test/org/apache/axis/om/CompareOMWithDOMTest.java
webservices/axis/trunk/java/modules/om/src/test/org/apache/axis/om/IteratorTester.java
webservices/axis/trunk/java/modules/om/src/test/org/apache/axis/om/MessagesTest.java
webservices/axis/trunk/java/modules/om/src/test/org/apache/axis/om/OMBodyTest.java
webservices/axis/trunk/java/modules/om/src/test/org/apache/axis/om/OMChildrenQNameIteratorTest.java
webservices/axis/trunk/java/modules/om/src/test/org/apache/axis/om/OMEnvelopeTest.java
webservices/axis/trunk/java/modules/om/src/test/org/apache/axis/om/OMHeaderBlockTest.java
webservices/axis/trunk/java/modules/om/src/test/org/apache/axis/om/OMHeaderTest.java
webservices/axis/trunk/java/modules/om/src/test/org/apache/axis/om/OMNavigatorTest.java
webservices/axis/trunk/java/modules/om/src/test/org/apache/axis/om/OMTest.java
webservices/axis/trunk/java/modules/om/src/test/org/apache/axis/om/OMTestCase.java
webservices/axis/trunk/java/modules/om/src/test/org/apache/axis/om/OMTestUtils.java
webservices/axis/trunk/java/modules/om/src/test/org/apache/axis/om/SOAPFaultTest.java
webservices/axis/trunk/java/modules/om/src/test/org/apache/axis/om/factory/OMLinkedListImplFactoryTest.java
webservices/axis/trunk/java/modules/om/src/test/org/apache/axis/om/impl/builder/StAXOMBuilderTest.java
webservices/axis/trunk/java/modules/om/src/test/org/apache/axis/om/impl/serializer/ElementSerializerTest.java
webservices/axis/trunk/java/modules/om/src/test/org/apache/axis/om/impl/serializer/OMSerailizerTest.java
webservices/axis/trunk/java/modules/om/src/test/org/apache/axis/om/impl/streamwrapper/OMStaxStreamingWrapperTest.java
webservices/axis/trunk/java/modules/om/src/test/org/apache/axis/om/impl/streamwrapper/OmStAXBuilderTest.java
webservices/axis/trunk/java/modules/om/src/test/org/apache/axis/om/impl/traverse/OMChildrenWithSpecificAttributeIteratorTest.java
Modified: webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/FactoryFinder.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/FactoryFinder.java?view=diff&r1=154467&r2=154468
==============================================================================
--- webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/FactoryFinder.java (original)
+++ webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/FactoryFinder.java Sat Feb 19 19:00:47 2005
@@ -1,23 +1,29 @@
/*
* Copyright 2004,2005 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.axis.om;
+/**
+ * Class FactoryFinder
+ */
class FactoryFinder {
- private static final String DEFAULT_CLASS_NAME = "org.apache.axis.om.impl.llom.factory.OMLinkedListImplFactory";
+ /**
+ * Field DEFAULT_CLASS_NAME
+ */
+ private static final String DEFAULT_CLASS_NAME =
+ "org.apache.axis.om.impl.llom.factory.OMLinkedListImplFactory";
/**
* This needs to be improved. Currently the factory is loaded only from the default implementation
@@ -26,8 +32,10 @@
*
* @param loader
* @return
+ * @throws OMFactoryException
*/
- public static OMFactory findFactory(ClassLoader loader) throws OMFactoryException {
+ public static OMFactory findFactory(ClassLoader loader)
+ throws OMFactoryException {
Object factory = null;
try {
if (loader == null) {
@@ -35,11 +43,9 @@
} else {
factory = loader.loadClass(DEFAULT_CLASS_NAME).newInstance();
}
-
} catch (Exception e) {
throw new OMFactoryException(e);
}
return (OMFactory) factory;
-
}
}
Modified: webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMAttribute.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMAttribute.java?view=diff&r1=154467&r2=154468
==============================================================================
--- webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMAttribute.java (original)
+++ webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMAttribute.java Sat Feb 19 19:00:47 2005
@@ -1,23 +1,25 @@
/*
* Copyright 2004,2005 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.axis.om;
import javax.xml.namespace.QName;
+/**
+ * Interface OMAttribute
+ */
public interface OMAttribute {
/**
* @return localName
@@ -40,8 +42,8 @@
public void setValue(String value);
/**
- * @param omNamespace
- */
+ * @param omNamespace
+ */
public void setOMNamespace(OMNamespace omNamespace);
/**
@@ -50,9 +52,7 @@
public OMNamespace getNamespace();
/**
- * @return javax.xml.namespace.QName
- */
+ * @return javax.xml.namespace.QName
+ */
public QName getQName();
-
-
}
Modified: webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMConstants.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMConstants.java?view=diff&r1=154467&r2=154468
==============================================================================
--- webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMConstants.java (original)
+++ webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMConstants.java Sat Feb 19 19:00:47 2005
@@ -1,55 +1,159 @@
/*
* Copyright 2004,2005 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.axis.om;
+/**
+ * Interface OMConstants
+ */
public interface OMConstants {
- public static final String SOAP_ENVELOPE_NAMESPACE_URI = "http://schemas.xmlsoap.org/soap/envelope/";
+ /**
+ * Field SOAP_ENVELOPE_NAMESPACE_URI
+ */
+ public static final String SOAP_ENVELOPE_NAMESPACE_URI =
+ "http://schemas.xmlsoap.org/soap/envelope/";
+
+ /**
+ * Field SOAPENVELOPE_NAMESPACE_PREFIX
+ */
public static final String SOAPENVELOPE_NAMESPACE_PREFIX = "soapenv";
+
+ /**
+ * Field SOAPENVELOPE_LOCAL_NAME
+ */
public static final String SOAPENVELOPE_LOCAL_NAME = "Envelope";
// Header constants
- public static final String HEADER_NAMESPACEURI = SOAP_ENVELOPE_NAMESPACE_URI;
+ /**
+ * Field HEADER_NAMESPACEURI
+ */
+ public static final String HEADER_NAMESPACEURI =
+ SOAP_ENVELOPE_NAMESPACE_URI;
+
+ /**
+ * Field HEADER_LOCAL_NAME
+ */
public static final String HEADER_LOCAL_NAME = "Header";
- public static final String HEADER_NAMESPACE_PREFIX = SOAPENVELOPE_NAMESPACE_PREFIX;
+
+ /**
+ * Field HEADER_NAMESPACE_PREFIX
+ */
+ public static final String HEADER_NAMESPACE_PREFIX =
+ SOAPENVELOPE_NAMESPACE_PREFIX;
// Body Constants
+ /**
+ * Field BODY_NAMESPACE_URI
+ */
public static final String BODY_NAMESPACE_URI = SOAP_ENVELOPE_NAMESPACE_URI;
+
+ /**
+ * Field BODY_LOCAL_NAME
+ */
public static final String BODY_LOCAL_NAME = "Body";
- public static final String BODY_NAMESPACE_PREFIX = SOAPENVELOPE_NAMESPACE_PREFIX;
+
+ /**
+ * Field BODY_NAMESPACE_PREFIX
+ */
+ public static final String BODY_NAMESPACE_PREFIX =
+ SOAPENVELOPE_NAMESPACE_PREFIX;
+
+ /**
+ * Field BODY_FAULT_LOCAL_NAME
+ */
public static final String BODY_FAULT_LOCAL_NAME = "Fault";
// Attribute names of a SOAP Envelope
+ /**
+ * Field ATTR_ACTOR
+ */
public static final String ATTR_ACTOR = "actor";
+
+ /**
+ * Field ATTR_MUSTUNDERSTAND
+ */
public static final String ATTR_MUSTUNDERSTAND = "mustUnderstand";
+ /**
+ * Field SOAPFAULT_LOCAL_NAME
+ */
public static final String SOAPFAULT_LOCAL_NAME = "Fault";
+
+ /**
+ * Field SOAPFAULT_CODE_LOCAL_NAME
+ */
public static final String SOAPFAULT_CODE_LOCAL_NAME = "faultcode";
+
+ /**
+ * Field SOAPFAULT_STRING_LOCAL_NAME
+ */
public static final String SOAPFAULT_STRING_LOCAL_NAME = "faultstring";
+
+ /**
+ * Field SOAPFAULT_ACTOR_LOCAL_NAME
+ */
public static final String SOAPFAULT_ACTOR_LOCAL_NAME = "faultactor";
+
+ /**
+ * Field SOAPFAULT_DETAIL_LOCAL_NAME
+ */
public static final String SOAPFAULT_DETAIL_LOCAL_NAME = "detail";
- public static final String SOAPFAULT_NAMESPACE_URI = SOAP_ENVELOPE_NAMESPACE_URI;
- public static final String SOAPFAULT_NAMESPACE_PREFIX = SOAPENVELOPE_NAMESPACE_PREFIX;
- //OMBuilder constants
+ /**
+ * Field SOAPFAULT_NAMESPACE_URI
+ */
+ public static final String SOAPFAULT_NAMESPACE_URI =
+ SOAP_ENVELOPE_NAMESPACE_URI;
+
+ /**
+ * Field SOAPFAULT_NAMESPACE_PREFIX
+ */
+ public static final String SOAPFAULT_NAMESPACE_PREFIX =
+ SOAPENVELOPE_NAMESPACE_PREFIX;
+
+ // OMBuilder constants
+ /**
+ * Field PUSH_TYPE_BUILDER
+ */
public static final short PUSH_TYPE_BUILDER = 0;
+
+ /**
+ * Field PULL_TYPE_BUILDER
+ */
public static final short PULL_TYPE_BUILDER = 1;
- public static final String ARRAY_ITEM_NSURI = "http://axis.apache.org/encoding/Arrays";
+ /**
+ * Field ARRAY_ITEM_NSURI
+ */
+ public static final String ARRAY_ITEM_NSURI =
+ "http://axis.apache.org/encoding/Arrays";
+
+ /**
+ * Field ARRAY_ITEM_LOCALNAME
+ */
public static final String ARRAY_ITEM_LOCALNAME = "item";
+
+ /**
+ * Field ARRAY_ITEM_NS_PREFIX
+ */
public static final String ARRAY_ITEM_NS_PREFIX = "arrays";
- public static final String ARRAY_ITEM_QNAME = OMConstants.ARRAY_ITEM_NS_PREFIX + ':' + OMConstants.ARRAY_ITEM_LOCALNAME;
+
+ /**
+ * Field ARRAY_ITEM_QNAME
+ */
+ public static final String ARRAY_ITEM_QNAME =
+ OMConstants.ARRAY_ITEM_NS_PREFIX + ':'
+ + OMConstants.ARRAY_ITEM_LOCALNAME;
}
Modified: webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMElement.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMElement.java?view=diff&r1=154467&r2=154468
==============================================================================
--- webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMElement.java (original)
+++ webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMElement.java Sat Feb 19 19:00:47 2005
@@ -1,25 +1,27 @@
/*
* Copyright 2004,2005 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.axis.om;
import javax.xml.namespace.QName;
import javax.xml.stream.XMLStreamReader;
import java.util.Iterator;
+/**
+ * Interface OMElement
+ */
public interface OMElement extends OMNamedNode {
/**
* This will add child to the element. One must preserve the order of children, in this operation
@@ -52,6 +54,8 @@
/**
* This returns a collection of this element.
* Children can be of types OMElement, OMText.
+ *
+ * @return
*/
public Iterator getChildren();
@@ -80,7 +84,8 @@
* @return
* @throws OMException
*/
- public OMNamespace findInScopeNamespace(String uri, String prefix) throws OMException;
+ public OMNamespace findInScopeNamespace(String uri, String prefix)
+ throws OMException;
/**
* This will ckeck for the namespace <B>only</B> in the current Element
@@ -90,7 +95,8 @@
* @return
* @throws OMException
*/
- public OMNamespace findDeclaredNamespace(String uri, String prefix) throws OMException;
+ public OMNamespace findDeclaredNamespace(String uri, String prefix)
+ throws OMException;
/**
* This will provide a list of namespace defined within this Element <B>only</B>
@@ -121,6 +127,7 @@
* in the front or at the end of set of attributes
*
* @param attr
+ * @return
*/
public OMAttribute insertAttribute(OMAttribute attr);
@@ -131,12 +138,28 @@
* must be declared in the parent element of this attribute or ancestors of the parent element of the attribute
* @return
*/
- public OMAttribute insertAttribute(String attributeName, String value, OMNamespace ns);
+ public OMAttribute insertAttribute(String attributeName, String value,
+ OMNamespace ns);
+ /**
+ * Method removeAttribute
+ *
+ * @param attr
+ */
public void removeAttribute(OMAttribute attr);
+ /**
+ * Method setBuilder
+ *
+ * @param wrapper
+ */
public void setBuilder(OMXMLParserWrapper wrapper);
+ /**
+ * Method getBuilder
+ *
+ * @return
+ */
public OMXMLParserWrapper getBuilder();
/**
Modified: webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMException.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMException.java?view=diff&r1=154467&r2=154468
==============================================================================
--- webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMException.java (original)
+++ webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMException.java Sat Feb 19 19:00:47 2005
@@ -1,33 +1,54 @@
/*
* Copyright 2004,2005 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.axis.om;
+/**
+ * Class OMException
+ */
public class OMException extends RuntimeException {
+ /**
+ * Constructor OMException
+ */
public OMException() {
}
+ /**
+ * Constructor OMException
+ *
+ * @param message
+ */
public OMException(String message) {
super(message);
}
+ /**
+ * Constructor OMException
+ *
+ * @param message
+ * @param cause
+ */
public OMException(String message, Throwable cause) {
super(message, cause);
}
+ /**
+ * Constructor OMException
+ *
+ * @param cause
+ */
public OMException(Throwable cause) {
super(cause);
}
Modified: webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMFactory.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMFactory.java?view=diff&r1=154467&r2=154468
==============================================================================
--- webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMFactory.java (original)
+++ webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMFactory.java Sat Feb 19 19:00:47 2005
@@ -1,23 +1,25 @@
/*
* Copyright 2004,2005 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.axis.om;
import javax.xml.namespace.QName;
+/**
+ * Class OMFactory
+ */
public abstract class OMFactory {
/**
* @param localName
@@ -33,7 +35,9 @@
* @param builder
* @return
*/
- public abstract OMElement createOMElement(String localName, OMNamespace ns, OMElement parent, OMXMLParserWrapper builder);
+ public abstract OMElement createOMElement(String localName, OMNamespace ns,
+ OMElement parent,
+ OMXMLParserWrapper builder);
/**
* This is almost the same as as createOMElement(localName,OMNamespace) method above.
@@ -46,7 +50,9 @@
* @param namespacePrefix
* @return
*/
- public abstract OMElement createOMElement(String localName, String namespaceURI, String namespacePrefix);
+ public abstract OMElement createOMElement(String localName,
+ String namespaceURI,
+ String namespacePrefix);
/**
* QName(localPart),
@@ -54,9 +60,12 @@
* QName(namespaceURI, localPart, prefix)
*
* @param qname
+ * @param parent
* @return
+ * @throws OMException
*/
- public abstract OMElement createOMElement(QName qname, OMElement parent) throws OMException;
+ public abstract OMElement createOMElement(QName qname, OMElement parent)
+ throws OMException;
/**
* @param uri
@@ -89,22 +98,26 @@
* @param builder
* @return
*/
- public abstract SOAPBody createSOAPBody(SOAPEnvelope envelope, OMXMLParserWrapper builder);
+ public abstract SOAPBody createSOAPBody(SOAPEnvelope envelope,
+ OMXMLParserWrapper builder);
/**
* @param ns
* @param builder
* @return
*/
- public abstract SOAPEnvelope createSOAPEnvelope(OMNamespace ns, OMXMLParserWrapper builder);
+ public abstract SOAPEnvelope createSOAPEnvelope(OMNamespace ns,
+ OMXMLParserWrapper builder);
/**
* @param ns
+ * @return
*/
public abstract SOAPEnvelope createSOAPEnvelope(OMNamespace ns);
/**
* @param envelope
+ * @return
*/
public abstract SOAPHeader createSOAPHeader(SOAPEnvelope envelope);
@@ -113,13 +126,16 @@
* @param builder
* @return
*/
- public abstract SOAPHeader createSOAPHeader(SOAPEnvelope envelope, OMXMLParserWrapper builder);
+ public abstract SOAPHeader createSOAPHeader(SOAPEnvelope envelope,
+ OMXMLParserWrapper builder);
/**
* @param localName
* @param ns
+ * @return
*/
- public abstract SOAPHeaderBlock createSOAPHeaderBlock(String localName, OMNamespace ns);
+ public abstract SOAPHeaderBlock createSOAPHeaderBlock(String localName,
+ OMNamespace ns);
/**
* @param localName
@@ -128,10 +144,12 @@
* @param builder
* @return
*/
- public abstract SOAPHeaderBlock createSOAPHeaderBlock(String localName, OMNamespace ns, OMElement parent, OMXMLParserWrapper builder);
+ public abstract SOAPHeaderBlock createSOAPHeaderBlock(String localName,
+ OMNamespace ns, OMElement parent, OMXMLParserWrapper builder);
/**
* @param parent
+ * @param e
* @return
*/
public abstract SOAPFault createSOAPFault(SOAPBody parent, Exception e);
@@ -142,17 +160,30 @@
* @param builder
* @return
*/
- public abstract SOAPFault createSOAPFault(OMNamespace ns, SOAPBody parent, OMXMLParserWrapper builder);
+ public abstract SOAPFault createSOAPFault(OMNamespace ns, SOAPBody parent,
+ OMXMLParserWrapper builder);
+ // make the constructor protected
- //make the constructor protected
+ /**
+ * Constructor OMFactory
+ */
protected OMFactory() {
}
+ /**
+ * Method newInstance
+ *
+ * @return
+ */
public static OMFactory newInstance() {
return FactoryFinder.findFactory(null);
}
+ /**
+ * Method getDefaultEnvelope
+ *
+ * @return
+ */
public abstract SOAPEnvelope getDefaultEnvelope();
-
-}
\ No newline at end of file
+}
Modified: webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMFactoryException.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMFactoryException.java?view=diff&r1=154467&r2=154468
==============================================================================
--- webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMFactoryException.java (original)
+++ webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMFactoryException.java Sat Feb 19 19:00:47 2005
@@ -1,33 +1,54 @@
/*
* Copyright 2004,2005 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.axis.om;
+/**
+ * Class OMFactoryException
+ */
public class OMFactoryException extends OMException {
+ /**
+ * Constructor OMFactoryException
+ */
public OMFactoryException() {
}
+ /**
+ * Constructor OMFactoryException
+ *
+ * @param message
+ */
public OMFactoryException(String message) {
super(message);
}
+ /**
+ * Constructor OMFactoryException
+ *
+ * @param message
+ * @param cause
+ */
public OMFactoryException(String message, Throwable cause) {
super(message, cause);
}
+ /**
+ * Constructor OMFactoryException
+ *
+ * @param cause
+ */
public OMFactoryException(Throwable cause) {
super(cause);
}
Modified: webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMNamedNode.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMNamedNode.java?view=diff&r1=154467&r2=154468
==============================================================================
--- webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMNamedNode.java (original)
+++ webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMNamedNode.java Sat Feb 19 19:00:47 2005
@@ -1,31 +1,57 @@
/*
* Copyright 2004,2005 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.axis.om;
+/**
+ * Interface OMNamedNode
+ */
public interface OMNamedNode extends OMNode {
+ /**
+ * Method getLocalName
+ *
+ * @return
+ */
public String getLocalName();
+ /**
+ * Method setLocalName
+ *
+ * @param localName
+ */
public void setLocalName(String localName);
+ /**
+ * Method getNamespace
+ *
+ * @return
+ * @throws OMException
+ */
public OMNamespace getNamespace() throws OMException;
+ /**
+ * Method getNamespaceName
+ *
+ * @return
+ */
public String getNamespaceName();
+ /**
+ * Method setNamespace
+ *
+ * @param namespace
+ */
public void setNamespace(OMNamespace namespace);
-
-
}
Modified: webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMNamespace.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMNamespace.java?view=diff&r1=154467&r2=154468
==============================================================================
--- webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMNamespace.java (original)
+++ webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMNamespace.java Sat Feb 19 19:00:47 2005
@@ -1,26 +1,44 @@
/*
* Copyright 2004,2005 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.axis.om;
+/**
+ * Interface OMNamespace
+ */
public interface OMNamespace {
+ /**
+ * Method equals
+ *
+ * @param uri
+ * @param prefix
+ * @return
+ */
public boolean equals(String uri, String prefix);
+ /**
+ * Method getPrefix
+ *
+ * @return
+ */
public String getPrefix();
+ /**
+ * Method getName
+ *
+ * @return
+ */
public String getName();
-
}
Modified: webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMNode.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMNode.java?view=diff&r1=154467&r2=154468
==============================================================================
--- webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMNode.java (original)
+++ webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMNode.java Sat Feb 19 19:00:47 2005
@@ -1,40 +1,42 @@
/*
* Copyright 2004,2005 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.axis.om;
import javax.xml.stream.XMLStreamException;
import javax.xml.stream.XMLStreamWriter;
+/**
+ * Interface OMNode
+ */
public interface OMNode {
- //==================================================================================
-
- // Followings are the codes for node types. Extracted these from DOM API
/**
* The node is an <code>Element</code>.
*/
public static final short ELEMENT_NODE = 1;
+
/**
* The node is an <code>Attr</code>.
*/
public static final short ATTRIBUTE_NODE = 2;
+
/**
* The node is a <code>Text</code> node.
*/
public static final short TEXT_NODE = 3;
+
/**
* The node is a <code>CDATASection</code>.
*/
@@ -44,13 +46,12 @@
* The node is a <code>Comment</code>.
*/
public static final short COMMENT_NODE = 8;
+
/**
* The node is a <code>Document</code>.
*/
public static final short DOCUMENT_NODE = 9;
- //==================================================================================
-
/**
* This method should return the immediate parent of the node.
* Parent is always an Element
@@ -60,6 +61,11 @@
*/
public OMElement getParent() throws OMException;
+ /**
+ * Method setParent
+ *
+ * @param element
+ */
public void setParent(OMElement element);
/**
@@ -70,6 +76,11 @@
*/
public OMNode getNextSibling() throws OMException;
+ /**
+ * Method setNextSibling
+ *
+ * @param node
+ */
public void setNextSibling(OMNode node);
/**
@@ -83,6 +94,11 @@
*/
public String getValue() throws OMException;
+ /**
+ * Method setValue
+ *
+ * @param value
+ */
public void setValue(String value);
/**
@@ -94,6 +110,11 @@
*/
public boolean isComplete();
+ /**
+ * Method setComplete
+ *
+ * @param state
+ */
public void setComplete(boolean state);
/**
@@ -127,6 +148,12 @@
*/
public short getType() throws OMException;
+ /**
+ * Method setType
+ *
+ * @param nodeType
+ * @throws OMException
+ */
public void setType(short nodeType) throws OMException;
/**
@@ -148,6 +175,6 @@
* @param cache
* @throws XMLStreamException
*/
- public void serialize(XMLStreamWriter writer, boolean cache) throws XMLStreamException;
-
+ public void serialize(XMLStreamWriter writer, boolean cache)
+ throws XMLStreamException;
}
Modified: webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMSerializer.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMSerializer.java?view=diff&r1=154467&r2=154468
==============================================================================
--- webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMSerializer.java (original)
+++ webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMSerializer.java Sat Feb 19 19:00:47 2005
@@ -1,27 +1,34 @@
/*
* Copyright 2004,2005 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.axis.om;
import javax.xml.stream.XMLStreamException;
import javax.xml.stream.XMLStreamWriter;
+/**
+ * Interface OMSerializer
+ */
public interface OMSerializer {
- void serialize(Object obj, XMLStreamWriter writer) throws XMLStreamException;
- // Stack getNamespacePrefixStack();
- // void setNamespacePrefixStack(Stack namespacePrefixStack);
-
+ /**
+ * Method serialize
+ *
+ * @param obj
+ * @param writer
+ * @throws XMLStreamException
+ */
+ void serialize(Object obj, XMLStreamWriter writer)
+ throws XMLStreamException;
}
Modified: webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMText.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMText.java?view=diff&r1=154467&r2=154468
==============================================================================
--- webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMText.java (original)
+++ webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMText.java Sat Feb 19 19:00:47 2005
@@ -1,21 +1,23 @@
/*
* Copyright 2004,2005 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.axis.om;
+/**
+ * Interface OMText
+ */
public interface OMText extends OMNode {
/**
* We use the OMText class to hold comments, text, characterData, CData, etc.,
@@ -25,5 +27,10 @@
*/
public void setTextType(short type);
+ /**
+ * Method getTextType
+ *
+ * @return
+ */
public short getTextType();
}
Modified: webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMUtils.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMUtils.java?view=diff&r1=154467&r2=154468
==============================================================================
--- webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMUtils.java (original)
+++ webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMUtils.java Sat Feb 19 19:00:47 2005
@@ -1,42 +1,49 @@
/*
* Copyright 2004,2005 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.axis.om;
-
-import java.util.Iterator;
-
-public class OMUtils {
- public static OMElement getFirstChildElement(OMElement omele) {
- OMElement childElement = null;
- OMNode child = null;
- if (omele != null) {
- Iterator it = omele.getChildren();
- if (it.hasNext()) {
- child = (OMNode) it.next();
- while (OMNode.ELEMENT_NODE != child.getType()) {
- if (it.hasNext()) {
- child = (OMNode) it.next();
- } else {
- break;
- }
- }
- childElement = (OMElement) child;
- }
-
- }
- return childElement;
- }
-}
+package org.apache.axis.om;
+
+import java.util.Iterator;
+
+/**
+ * Class OMUtils
+ */
+public class OMUtils {
+ /**
+ * Method getFirstChildElement
+ *
+ * @param omele
+ * @return
+ */
+ public static OMElement getFirstChildElement(OMElement omele) {
+ OMElement childElement = null;
+ OMNode child = null;
+ if (omele != null) {
+ Iterator it = omele.getChildren();
+ if (it.hasNext()) {
+ child = (OMNode) it.next();
+ while (OMNode.ELEMENT_NODE != child.getType()) {
+ if (it.hasNext()) {
+ child = (OMNode) it.next();
+ } else {
+ break;
+ }
+ }
+ childElement = (OMElement) child;
+ }
+ }
+ return childElement;
+ }
+}
Modified: webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMXMLParserWrapper.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMXMLParserWrapper.java?view=diff&r1=154467&r2=154468
==============================================================================
--- webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMXMLParserWrapper.java (original)
+++ webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/OMXMLParserWrapper.java Sat Feb 19 19:00:47 2005
@@ -1,27 +1,30 @@
/*
* Copyright 2004,2005 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.axis.om;
+/**
+ * Interface OMXMLParserWrapper
+ */
public interface OMXMLParserWrapper {
/**
* Proceed the parser one step and return the event value
*
* @return
* @throws org.apache.axis.om.OMException
+ * @throws OMException
*/
int next() throws OMException;
@@ -31,12 +34,14 @@
*
* @param el
* @throws org.apache.axis.om.OMException
+ * @throws OMException
*/
void discard(OMElement el) throws OMException;
/**
* @param b
* @throws org.apache.axis.om.OMException
+ * @throws OMException
*/
void setCache(boolean b) throws OMException;
@@ -84,5 +89,4 @@
* @return
*/
Object getRegisteredContentHandler();
-
}
Modified: webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/SOAPBody.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/SOAPBody.java?view=diff&r1=154467&r2=154468
==============================================================================
--- webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/SOAPBody.java (original)
+++ webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/SOAPBody.java Sat Feb 19 19:00:47 2005
@@ -1,19 +1,18 @@
/*
* Copyright 2004,2005 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.axis.om;
/**
@@ -31,8 +30,10 @@
* Creates a new <code>SOAPFault</code> object and adds it to
* this <code>SOAPBody</code> object.
*
+ * @param e
* @return the new <code>SOAPFault</code> object
* @throws org.apache.axis.om.OMException if there is a SOAP error
+ * @throws OMException
*/
public abstract SOAPFault addFault(Exception e) throws OMException;
@@ -60,6 +61,4 @@
* @throws OMException
*/
public abstract void addFault(SOAPFault soapFault) throws OMException;
-
-
}
Modified: webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/SOAPEnvelope.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/SOAPEnvelope.java?view=diff&r1=154467&r2=154468
==============================================================================
--- webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/SOAPEnvelope.java (original)
+++ webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/SOAPEnvelope.java Sat Feb 19 19:00:47 2005
@@ -1,40 +1,41 @@
/*
* Copyright 2004,2005 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.axis.om;
+/**
+ * Interface SOAPEnvelope
+ */
public interface SOAPEnvelope extends OMElement {
/**
- * Returns the <CODE>SOAPHeader</CODE> object for this <CODE>
- * SOAPEnvelope</CODE> object.
- * <P> This SOAPHeader will just be a container for all the headers in the
- * <CODE>OMMessage</CODE>
- * </P>
- *
- * @return the <CODE>SOAPHeader</CODE> object or <CODE>
- * null</CODE> if there is none
- * @throws OMException if there is a problem
- * obtaining the <CODE>SOAPHeader</CODE> object
- */
+ * Returns the <CODE>SOAPHeader</CODE> object for this <CODE>
+ * SOAPEnvelope</CODE> object.
+ * <P> This SOAPHeader will just be a container for all the headers in the
+ * <CODE>OMMessage</CODE>
+ * </P>
+ *
+ * @return the <CODE>SOAPHeader</CODE> object or <CODE>
+ * null</CODE> if there is none
+ * @throws OMException if there is a problem
+ * obtaining the <CODE>SOAPHeader</CODE> object
+ */
public abstract SOAPHeader getHeader() throws OMException;
/**
* Returns the <CODE>SOAPBody</CODE> object associated with
* this <CODE>SOAPEnvelope</CODE> object.
- * <p/>
* <P> This SOAPBody will just be a container for all the BodyElements in the
* <CODE>OMMessage</CODE>
* </P>
@@ -46,6 +47,4 @@
* obtaining the <CODE>SOAPBody</CODE> object
*/
public abstract SOAPBody getBody() throws OMException;
-
-
}
Modified: webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/SOAPFault.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/SOAPFault.java?view=diff&r1=154467&r2=154468
==============================================================================
--- webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/SOAPFault.java (original)
+++ webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/SOAPFault.java Sat Feb 19 19:00:47 2005
@@ -1,19 +1,18 @@
/*
* Copyright 2004,2005 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.axis.om;
import javax.xml.namespace.QName;
@@ -40,19 +39,19 @@
*/
public interface SOAPFault extends OMElement {
/**
- * Sets this <CODE>SOAPFault</CODE> object with the given
- * fault code.
- * <P>Fault codes, which given information about the fault,
- * are defined in the SOAP 1.1 specification.</P>
- *
- * @param faultCode a <CODE>QName</CODE> giving
- * the fault code to be set; must be one of the fault codes
- * defined in the SOAP 1.1 specification
- * @throws OMException if there was an error in
- * adding the <CODE>faultCode</CODE> to the underlying XML
- * tree.
- * @see #getFaultCode() getFaultCode()
- */
+ * Sets this <CODE>SOAPFault</CODE> object with the given
+ * fault code.
+ * <P>Fault codes, which given information about the fault,
+ * are defined in the SOAP 1.1 specification.</P>
+ *
+ * @param faultCode a <CODE>QName</CODE> giving
+ * the fault code to be set; must be one of the fault codes
+ * defined in the SOAP 1.1 specification
+ * @throws OMException if there was an error in
+ * adding the <CODE>faultCode</CODE> to the underlying XML
+ * tree.
+ * @see #getFaultCode() getFaultCode()
+ */
public abstract void setFaultCode(QName faultCode) throws OMException;
/**
@@ -65,19 +64,19 @@
public abstract QName getFaultCode();
/**
- * Sets this <CODE>SOAPFault</CODE> object with the given
- * fault actor.
- * <P>The fault actor is the recipient in the message path who
- * caused the fault to happen.</P>
- *
- * @param faultActor a <CODE>String</CODE>
- * identifying the actor that caused this <CODE>
- * SOAPFault</CODE> object
- * @throws OMException if there was an error in
- * adding the <CODE>faultActor</CODE> to the underlying XML
- * tree.
- * @see #getFaultActor() getFaultActor()
- */
+ * Sets this <CODE>SOAPFault</CODE> object with the given
+ * fault actor.
+ * <P>The fault actor is the recipient in the message path who
+ * caused the fault to happen.</P>
+ *
+ * @param faultActor a <CODE>String</CODE>
+ * identifying the actor that caused this <CODE>
+ * SOAPFault</CODE> object
+ * @throws OMException if there was an error in
+ * adding the <CODE>faultActor</CODE> to the underlying XML
+ * tree.
+ * @see #getFaultActor() getFaultActor()
+ */
public abstract void setFaultActor(String faultActor) throws OMException;
/**
@@ -101,8 +100,7 @@
* tree.
* @see #getFaultString() getFaultString()
*/
- public abstract void setFaultString(String faultString)
- throws OMException;
+ public abstract void setFaultString(String faultString) throws OMException;
/**
* Gets the fault string for this <CODE>SOAPFault</CODE>
@@ -120,7 +118,18 @@
*/
public abstract void setDetailInformation(OMNode detail);
+ /**
+ * Method getDetailInformation
+ *
+ * @return
+ */
public abstract OMNode getDetailInformation();
+ /**
+ * Method getException
+ *
+ * @return
+ * @throws OMException
+ */
public abstract Exception getException() throws OMException;
}
Modified: webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/SOAPHeader.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/SOAPHeader.java?view=diff&r1=154467&r2=154468
==============================================================================
--- webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/SOAPHeader.java (original)
+++ webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/SOAPHeader.java Sat Feb 19 19:00:47 2005
@@ -1,36 +1,40 @@
/*
* Copyright 2004,2005 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.axis.om;
import java.util.Iterator;
+/**
+ * Interface SOAPHeader
+ */
public interface SOAPHeader extends OMElement {
/**
* Creates a new <CODE>SOAPHeaderBlock</CODE> object
* initialized with the specified name and adds it to this
* <CODE>SOAPHeader</CODE> object.
*
+ * @param localName
+ * @param ns
* @return the new <CODE>SOAPHeaderBlock</CODE> object that
* was inserted into this <CODE>SOAPHeader</CODE>
* object
* @throws OMException if a SOAP error occurs
*/
- public abstract SOAPHeaderBlock addHeaderBlock(String localName, OMNamespace ns)
- throws OMException;
+ public abstract SOAPHeaderBlock addHeaderBlock(
+ String localName, OMNamespace ns) throws OMException;
/**
* Returns a list of all the <CODE>SOAPHeaderBlock</CODE>
@@ -53,22 +57,22 @@
public abstract Iterator examineHeaderBlocks(String actor);
/**
- * Returns a list of all the <CODE>SOAPHeaderBlock</CODE>
- * objects in this <CODE>SOAPHeader</CODE> object that have
- * the the specified actor and detaches them from this <CODE>
- * SOAPHeader</CODE> object.
- * <P>This method allows an actor to process only the parts of
- * the <CODE>SOAPHeader</CODE> object that apply to it and to
- * remove them before passing the message on to the next
- * actor.
- *
- * @param actor a <CODE>String</CODE> giving the
- * URI of the actor for which to search
- * @return an <CODE>Iterator</CODE> object over all the <CODE>
- * SOAPHeaderBlock</CODE> objects that contain the
- * specified actor
- * @see #examineHeaderBlocks(java.lang.String) examineHeaderBlocks(java.lang.String)
- */
+ * Returns a list of all the <CODE>SOAPHeaderBlock</CODE>
+ * objects in this <CODE>SOAPHeader</CODE> object that have
+ * the the specified actor and detaches them from this <CODE>
+ * SOAPHeader</CODE> object.
+ * <P>This method allows an actor to process only the parts of
+ * the <CODE>SOAPHeader</CODE> object that apply to it and to
+ * remove them before passing the message on to the next
+ * actor.
+ *
+ * @param actor a <CODE>String</CODE> giving the
+ * URI of the actor for which to search
+ * @return an <CODE>Iterator</CODE> object over all the <CODE>
+ * SOAPHeaderBlock</CODE> objects that contain the
+ * specified actor
+ * @see #examineHeaderBlocks(java.lang.String) examineHeaderBlocks(java.lang.String)
+ */
public abstract Iterator extractHeaderBlocks(String actor);
/**
Modified: webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/SOAPHeaderBlock.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/SOAPHeaderBlock.java?view=diff&r1=154467&r2=154468
==============================================================================
--- webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/SOAPHeaderBlock.java (original)
+++ webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/SOAPHeaderBlock.java Sat Feb 19 19:00:47 2005
@@ -1,19 +1,18 @@
/*
* Copyright 2004,2005 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.axis.om;
/**
@@ -51,22 +50,22 @@
public abstract String getActor();
/**
- * Sets the mustUnderstand attribute for this <CODE>
- * SOAPHeaderBlock</CODE> object to be on or off.
- * <P>If the mustUnderstand attribute is on, the actor who
- * receives the <CODE>SOAPHeaderBlock</CODE> must process it
- * correctly. This ensures, for example, that if the <CODE>
- * SOAPHeaderBlock</CODE> object modifies the message, that
- * the message is being modified correctly.</P>
- *
- * @param mustUnderstand <CODE>true</CODE> to
- * set the mustUnderstand attribute on; <CODE>false</CODE>
- * to turn if off
- * @throws java.lang.IllegalArgumentException
- * if
- * there is a problem in setting the actor.
- * @see #getMustUnderstand() getMustUnderstand()
- */
+ * Sets the mustUnderstand attribute for this <CODE>
+ * SOAPHeaderBlock</CODE> object to be on or off.
+ * <P>If the mustUnderstand attribute is on, the actor who
+ * receives the <CODE>SOAPHeaderBlock</CODE> must process it
+ * correctly. This ensures, for example, that if the <CODE>
+ * SOAPHeaderBlock</CODE> object modifies the message, that
+ * the message is being modified correctly.</P>
+ *
+ * @param mustUnderstand <CODE>true</CODE> to
+ * set the mustUnderstand attribute on; <CODE>false</CODE>
+ * to turn if off
+ * @throws java.lang.IllegalArgumentException
+ * if
+ * there is a problem in setting the actor.
+ * @see #getMustUnderstand() getMustUnderstand()
+ */
public abstract void setMustUnderstand(boolean mustUnderstand);
/**
Modified: webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/OMAttributeImpl.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/OMAttributeImpl.java?view=diff&r1=154467&r2=154468
==============================================================================
--- webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/OMAttributeImpl.java (original)
+++ webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/OMAttributeImpl.java Sat Feb 19 19:00:47 2005
@@ -1,19 +1,18 @@
/*
* Copyright 2004,2005 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.axis.om.impl.llom;
import org.apache.axis.om.OMAttribute;
@@ -23,54 +22,113 @@
import java.util.regex.Matcher;
import java.util.regex.Pattern;
+/**
+ * Class OMAttributeImpl
+ */
public class OMAttributeImpl implements OMAttribute {
+ /**
+ * Field localName
+ */
private String localName;
+
+ /**
+ * Field value
+ */
private String value;
+
+ /**
+ * Field namespace
+ */
private OMNamespace namespace;
+ /**
+ * Field QUOTE_ENTITY
+ */
private static String QUOTE_ENTITY = """;
+
+ /**
+ * Field matcher
+ */
private static Matcher matcher = Pattern.compile("\"").matcher(null);
+ /**
+ * Constructor OMAttributeImpl
+ *
+ * @param localName
+ * @param ns
+ * @param value
+ */
public OMAttributeImpl(String localName, OMNamespace ns, String value) {
setLocalName(localName);
setValue(value);
setOMNamespace(ns);
}
- // private static String replaceQuoteWithEntity(String value) {
- // matcher.reset(value);
- // return matcher.replaceAll(QUOTE_ENTITY);
- // }
-
+ /**
+ * Method getQName
+ *
+ * @return
+ */
public QName getQName() {
- String namespaceName = namespace != null ? namespace.getName() : null;
+ String namespaceName = (namespace != null)
+ ? namespace.getName()
+ : null;
return new QName(namespaceName, localName);
}
// -------- Getters and Setters
+
+ /**
+ * Method getLocalName
+ *
+ * @return
+ */
public String getLocalName() {
return localName;
}
+ /**
+ * Method setLocalName
+ *
+ * @param localName
+ */
public void setLocalName(String localName) {
this.localName = localName;
}
+ /**
+ * Method getValue
+ *
+ * @return
+ */
public String getValue() {
return value;
}
+ /**
+ * Method setValue
+ *
+ * @param value
+ */
public void setValue(String value) {
this.value = value;
}
+ /**
+ * Method setOMNamespace
+ *
+ * @param omNamespace
+ */
public void setOMNamespace(OMNamespace omNamespace) {
this.namespace = omNamespace;
}
+ /**
+ * Method getNamespace
+ *
+ * @return
+ */
public OMNamespace getNamespace() {
return namespace;
}
-
-
}
Modified: webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/OMDocument.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/OMDocument.java?view=diff&r1=154467&r2=154468
==============================================================================
--- webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/OMDocument.java (original)
+++ webservices/axis/trunk/java/modules/om/src/java/org/apache/axis/om/impl/llom/OMDocument.java Sat Feb 19 19:00:47 2005
@@ -1,26 +1,35 @@
/*
* Copyright 2004,2005 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.axis.om.impl.llom;
import org.apache.axis.om.OMElement;
import org.apache.axis.om.OMXMLParserWrapper;
+/**
+ * Class OMDocument
+ */
public class OMDocument {
+ /**
+ * Field rootElement
+ */
private OMElement rootElement;
+
+ /**
+ * Field parserWrapper
+ */
private OMXMLParserWrapper parserWrapper;
/**
@@ -39,6 +48,11 @@
this.parserWrapper = parserWrapper;
}
+ /**
+ * Method getRootElement
+ *
+ * @return
+ */
public OMElement getRootElement() {
if (rootElement == null) {
parserWrapper.next();
@@ -46,6 +60,11 @@
return rootElement;
}
+ /**
+ * Method setRootElement
+ *
+ * @param rootElement
+ */
public void setRootElement(OMElement rootElement) {
this.rootElement = rootElement;
}