You are viewing a plain text version of this content. The canonical link for it is here.
Posted to axis-cvs@ws.apache.org by di...@apache.org on 2006/01/06 20:46:52 UTC
svn commit: r366555 [2/4] - in /webservices/axis2/trunk/java/modules:
adb/src/org/apache/axis2/databinding/types/
adb/src/org/apache/axis2/databinding/utils/
codegen/src/org/apache/axis2/schema/
codegen/src/org/apache/axis2/schema/i18n/ codegen/src/org...
Modified: webservices/axis2/trunk/java/modules/common/src/org/apache/axis2/util/JavaUtils.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/common/src/org/apache/axis2/util/JavaUtils.java?rev=366555&r1=366554&r2=366555&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/common/src/org/apache/axis2/util/JavaUtils.java (original)
+++ webservices/axis2/trunk/java/modules/common/src/org/apache/axis2/util/JavaUtils.java Fri Jan 6 11:46:16 2006
@@ -1,182 +1,182 @@
-/*
-* 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.axis2.util;
-
-import java.text.Collator;
-import java.util.Arrays;
-import java.util.Locale;
-
-/**
- * JavaUtils
- */
-public class JavaUtils {
- /**
- * These are java keywords as specified at the following URL (sorted alphabetically).
- * http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#229308
- * Note that false, true, and null are not strictly keywords; they are literal values,
- * but for the purposes of this array, they can be treated as literals.
- * ****** PLEASE KEEP THIS LIST SORTED IN ASCENDING ORDER ******
- */
- static final String keywords[] =
- {
- "abstract", "assert", "boolean", "break", "byte", "case",
- "catch", "char", "class", "const", "continue",
- "default", "do", "double", "else", "extends",
- "false", "final", "finally", "float", "for",
- "goto", "if", "implements", "import", "instanceof",
- "int", "interface", "long", "native", "new",
- "null", "package", "private", "protected", "public",
- "return", "short", "static", "strictfp", "super",
- "switch", "synchronized", "this", "throw", "throws",
- "transient", "true", "try", "void", "volatile",
- "while"
- };
-
- /** Collator for comparing the strings */
- static final Collator englishCollator = Collator.getInstance(Locale.ENGLISH);
-
- /** Use this character as suffix */
- static final char keywordPrefix = '_';
-
- /**
- * Is this an XML punctuation character?
- */
- private static boolean isPunctuation(char c)
- {
- return '-' == c
- || '.' == c
- || ':' == c
- || '\u00B7' == c
- || '\u0387' == c
- || '\u06DD' == c
- || '\u06DE' == c;
- } // isPunctuation
-
- /**
- * checks if the input string is a valid java keyword.
- * @return boolean true/false
- */
- public static boolean isJavaKeyword(String keyword) {
- return (Arrays.binarySearch(keywords, keyword, englishCollator) >= 0);
- }
-
- /**
- * Turn a java keyword string into a non-Java keyword string. (Right now
- * this simply means appending an underscore.)
- */
- public static String makeNonJavaKeyword(String keyword){
- return keywordPrefix + keyword;
- }
-
- public static String xmlNameToJava(String name) {
- // protect ourselves from garbage
- if (name == null || name.equals(""))
- return name;
-
- char[] nameArray = name.toCharArray();
- int nameLen = name.length();
- StringBuffer result = new StringBuffer(nameLen);
- boolean wordStart = false;
-
- // The mapping indicates to convert first character.
- int i = 0;
- while (i < nameLen
- && (isPunctuation(nameArray[i])
- || !Character.isJavaIdentifierStart(nameArray[i]))) {
- i++;
- }
- if (i < nameLen) {
- // Decapitalization code used to be here, but we use the
- // Introspector function now after we filter out all bad chars.
-
- result.append(nameArray[i]);
- //wordStart = !Character.isLetter(nameArray[i]);
- wordStart = !Character.isLetter(nameArray[i]) && nameArray[i] != "_".charAt(0);
- }
- else {
- // The identifier cannot be mapped strictly according to
- // JSR 101
- if (Character.isJavaIdentifierPart(nameArray[0])) {
- result.append("_" + nameArray[0]);
- }
- else {
- // The XML identifier does not contain any characters
- // we can map to Java. Using the length of the string
- // will make it somewhat unique.
- result.append("_" + nameArray.length);
- }
- }
-
- // The mapping indicates to skip over
- // all characters that are not letters or
- // digits. The first letter/digit
- // following a skipped character is
- // upper-cased.
- for (++i; i < nameLen; ++i) {
- char c = nameArray[i];
-
- // if this is a bad char, skip it and remember to capitalize next
- // good character we encounter
- if (isPunctuation(c) || !Character.isJavaIdentifierPart(c)) {
- wordStart = true;
- continue;
- }
- if (wordStart && Character.isLowerCase(c)) {
- result.append(Character.toUpperCase(c));
- }
- else {
- result.append(c);
- }
- // If c is not a character, but is a legal Java
- // identifier character, capitalize the next character.
- // For example: "22hi" becomes "22Hi"
- //wordStart = !Character.isLetter(c);
- wordStart = !Character.isLetter(c) && c != "_".charAt(0);
- }
-
- // covert back to a String
- String newName = result.toString();
-
- // check for Java keywords
- if (isJavaKeyword(newName))
- newName = makeNonJavaKeyword(newName);
-
- return newName;
- } // xmlNameToJava
-
- /**
- * Capitalize the first character of the name.
- *
- * @param name
- * @return
- */
- public static String capitalizeFirstChar(String name) {
-
- if ((name == null) || name.equals("")) {
- return name;
- }
-
- char start = name.charAt(0);
-
- if (Character.isLowerCase(start)) {
- start = Character.toUpperCase(start);
-
- return start + name.substring(1);
- }
-
- return name;
- } // capitalizeFirstChar
-}
+/*
+* 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.axis2.util;
+
+import java.text.Collator;
+import java.util.Arrays;
+import java.util.Locale;
+
+/**
+ * JavaUtils
+ */
+public class JavaUtils {
+ /**
+ * These are java keywords as specified at the following URL (sorted alphabetically).
+ * http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#229308
+ * Note that false, true, and null are not strictly keywords; they are literal values,
+ * but for the purposes of this array, they can be treated as literals.
+ * ****** PLEASE KEEP THIS LIST SORTED IN ASCENDING ORDER ******
+ */
+ static final String keywords[] =
+ {
+ "abstract", "assert", "boolean", "break", "byte", "case",
+ "catch", "char", "class", "const", "continue",
+ "default", "do", "double", "else", "extends",
+ "false", "final", "finally", "float", "for",
+ "goto", "if", "implements", "import", "instanceof",
+ "int", "interface", "long", "native", "new",
+ "null", "package", "private", "protected", "public",
+ "return", "short", "static", "strictfp", "super",
+ "switch", "synchronized", "this", "throw", "throws",
+ "transient", "true", "try", "void", "volatile",
+ "while"
+ };
+
+ /** Collator for comparing the strings */
+ static final Collator englishCollator = Collator.getInstance(Locale.ENGLISH);
+
+ /** Use this character as suffix */
+ static final char keywordPrefix = '_';
+
+ /**
+ * Is this an XML punctuation character?
+ */
+ private static boolean isPunctuation(char c)
+ {
+ return '-' == c
+ || '.' == c
+ || ':' == c
+ || '\u00B7' == c
+ || '\u0387' == c
+ || '\u06DD' == c
+ || '\u06DE' == c;
+ } // isPunctuation
+
+ /**
+ * Checks if the input string is a valid java keyword.
+ * @return Returns boolean.
+ */
+ public static boolean isJavaKeyword(String keyword) {
+ return (Arrays.binarySearch(keywords, keyword, englishCollator) >= 0);
+ }
+
+ /**
+ * Turns a java keyword string into a non-Java keyword string. (Right now
+ * this simply means appending an underscore.)
+ */
+ public static String makeNonJavaKeyword(String keyword){
+ return keywordPrefix + keyword;
+ }
+
+ public static String xmlNameToJava(String name) {
+ // protect ourselves from garbage
+ if (name == null || name.equals(""))
+ return name;
+
+ char[] nameArray = name.toCharArray();
+ int nameLen = name.length();
+ StringBuffer result = new StringBuffer(nameLen);
+ boolean wordStart = false;
+
+ // The mapping indicates to convert first character.
+ int i = 0;
+ while (i < nameLen
+ && (isPunctuation(nameArray[i])
+ || !Character.isJavaIdentifierStart(nameArray[i]))) {
+ i++;
+ }
+ if (i < nameLen) {
+ // Decapitalization code used to be here, but we use the
+ // Introspector function now after we filter out all bad chars.
+
+ result.append(nameArray[i]);
+ //wordStart = !Character.isLetter(nameArray[i]);
+ wordStart = !Character.isLetter(nameArray[i]) && nameArray[i] != "_".charAt(0);
+ }
+ else {
+ // The identifier cannot be mapped strictly according to
+ // JSR 101
+ if (Character.isJavaIdentifierPart(nameArray[0])) {
+ result.append("_" + nameArray[0]);
+ }
+ else {
+ // The XML identifier does not contain any characters
+ // we can map to Java. Using the length of the string
+ // will make it somewhat unique.
+ result.append("_" + nameArray.length);
+ }
+ }
+
+ // The mapping indicates to skip over
+ // all characters that are not letters or
+ // digits. The first letter/digit
+ // following a skipped character is
+ // upper-cased.
+ for (++i; i < nameLen; ++i) {
+ char c = nameArray[i];
+
+ // if this is a bad char, skip it and remember to capitalize next
+ // good character we encounter
+ if (isPunctuation(c) || !Character.isJavaIdentifierPart(c)) {
+ wordStart = true;
+ continue;
+ }
+ if (wordStart && Character.isLowerCase(c)) {
+ result.append(Character.toUpperCase(c));
+ }
+ else {
+ result.append(c);
+ }
+ // If c is not a character, but is a legal Java
+ // identifier character, capitalize the next character.
+ // For example: "22hi" becomes "22Hi"
+ //wordStart = !Character.isLetter(c);
+ wordStart = !Character.isLetter(c) && c != "_".charAt(0);
+ }
+
+ // covert back to a String
+ String newName = result.toString();
+
+ // check for Java keywords
+ if (isJavaKeyword(newName))
+ newName = makeNonJavaKeyword(newName);
+
+ return newName;
+ } // xmlNameToJava
+
+ /**
+ * Capitalizes the first character of the name.
+ *
+ * @param name
+ * @return Returns String.
+ */
+ public static String capitalizeFirstChar(String name) {
+
+ if ((name == null) || name.equals("")) {
+ return name;
+ }
+
+ char start = name.charAt(0);
+
+ if (Character.isLowerCase(start)) {
+ start = Character.toUpperCase(start);
+
+ return start + name.substring(1);
+ }
+
+ return name;
+ } // capitalizeFirstChar
+}
Modified: webservices/axis2/trunk/java/modules/common/src/org/apache/axis2/util/Loader.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/common/src/org/apache/axis2/util/Loader.java?rev=366555&r1=366554&r2=366555&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/common/src/org/apache/axis2/util/Loader.java (original)
+++ webservices/axis2/trunk/java/modules/common/src/org/apache/axis2/util/Loader.java Fri Jan 6 11:46:16 2006
@@ -1,162 +1,158 @@
-/*
- * Copyright 2003-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.util;
-
-import org.apache.commons.logging.Log;
-import org.apache.commons.logging.LogFactory;
-
-import java.lang.reflect.InvocationTargetException;
-import java.net.URL;
-
-/**
- * Load resources (or images) from various sources.
- * <p/>
- */
-public class Loader {
- private static Log log = LogFactory.getLog(Loader.class.getName());
-
- /**
- * This method will search for <code>resource</code> in different
- * places. The rearch order is as follows:
- * <ol>
- * <p><li>Search for <code>resource</code> using the thread context
- * class loader under Java2. If that fails, search for
- * <code>resource</code> using the class loader that loaded this
- * class (<code>Loader</code>).
- * <p><li>Try one last time with
- * <code>ClassLoader.getSystemResource(resource)</code>, that is is
- * using the system class loader in JDK 1.2 and virtual machine's
- * built-in class loader in JDK 1.1.
- * </ol>
- * <p/>
- *
- * @param resource
- * @return TODO
- */
- static public URL getResource(String resource) {
- ClassLoader classLoader = null;
- URL url = null;
- try {
- // We could not find resource. Ler us now try with the
- // classloader that loaded this class.
- classLoader = getTCL();
- if (classLoader != null) {
- log.debug("Trying to find [" + resource + "] using " + classLoader + " class loader.");
- url = classLoader.getResource(resource);
- if (url != null) {
- return url;
- }
- }
- } catch (Throwable t) {
- log.warn("Caught Exception while in Loader.getResource. This may be innocuous.", t);
- }
-
- // Last ditch attempt: get the resource from the class path. It
- // may be the case that clazz was loaded by the Extentsion class
- // loader which the parent of the system class loader. Hence the
- // code below.
- log.debug("Trying to find [" + resource + "] using ClassLoader.getSystemResource().");
- return ClassLoader.getSystemResource(resource);
- }
-
-
- /**
- * Try to get the resource with the specified class loader
- * <p/>
- *
- * @param loader
- * @param resource
- * @return Class
- * @throws ClassNotFoundException
- */
- static public URL getResource(ClassLoader loader, String resource) throws ClassNotFoundException {
- URL url = null;
- try {
- if (loader != null) {
- log.debug("Trying to find [" + resource + "] using " + loader + " class loader.");
- url = loader.getResource(resource);
- if (url != null) {
- return url;
- }
- }
- } catch (Throwable t) {
- log.warn("Caught Exception while in Loader.getResource. This may be innocuous.", t);
- }
- return getResource(resource);
- }
-
- /**
- * Get the Thread context class loader.
- * <p/>
- *
- * @return
- * @throws IllegalAccessException
- * @throws InvocationTargetException
- */
- static public ClassLoader getTCL() throws IllegalAccessException, InvocationTargetException {
- return Thread.currentThread().getContextClassLoader();
- }
-
- /**
- * Try the specified classloader and then fall back to the loadClass
- * <p/>
- *
- * @param loader
- * @param clazz
- * @return Class
- * @throws ClassNotFoundException
- */
- static public Class loadClass(ClassLoader loader, String clazz) throws ClassNotFoundException {
- try {
- if(loader != null) {
- Class c = loader.loadClass(clazz);
- if (c != null)
- return c;
- }
- } catch (Throwable e) {
- }
- return loadClass(clazz);
- }
-
- /**
- * If running under JDK 1.2 load the specified class using the
- * <code>Thread</code> <code>contextClassLoader</code> if that
- * fails try Class.forname.
- * <p/>
- *
- * @param clazz
- * @return TODO
- * @throws ClassNotFoundException
- */
- static public Class loadClass(String clazz) throws ClassNotFoundException {
- try {
- ClassLoader tcl = getTCL();
-
- if(tcl != null) {
- Class c = tcl.loadClass(clazz);
- if (c != null)
- return c;
- }
- } catch (Throwable e) {
- }
- // we reached here because tcl was null or because of a
- // security exception, or because clazz could not be loaded...
- // In any case we now try one more time
- return Class.forName(clazz);
- }
-}
+/*
+ * Copyright 2003-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.util;
+
+import org.apache.commons.logging.Log;
+import org.apache.commons.logging.LogFactory;
+
+import java.lang.reflect.InvocationTargetException;
+import java.net.URL;
+
+/**
+ * Loads resources (or images) from various sources.
+ */
+public class Loader {
+ private static Log log = LogFactory.getLog(Loader.class.getName());
+
+ /**
+ * Searches for <code>resource</code> in different
+ * places. The search order is as follows:
+ * <ol>
+ * <p><li>Search for <code>resource</code> using the thread context
+ * class loader under Java2. If that fails, search for
+ * <code>resource</code> using the class loader that loaded this
+ * class (<code>Loader</code>).
+ * <p><li>Try one last time with
+ * <code>ClassLoader.getSystemResource(resource)</code>, that is is
+ * using the system class loader in JDK 1.2 and virtual machine's
+ * built-in class loader in JDK 1.1.
+ * </ol>
+ * <p/>
+ *
+ * @param resource
+ * @return Returns URL
+ */
+ static public URL getResource(String resource) {
+ ClassLoader classLoader = null;
+ URL url = null;
+ try {
+ // We could not find resource. Ler us now try with the
+ // classloader that loaded this class.
+ classLoader = getTCL();
+ if (classLoader != null) {
+ log.debug("Trying to find [" + resource + "] using " + classLoader + " class loader.");
+ url = classLoader.getResource(resource);
+ if (url != null) {
+ return url;
+ }
+ }
+ } catch (Throwable t) {
+ log.warn("Caught Exception while in Loader.getResource. This may be innocuous.", t);
+ }
+
+ // Last ditch attempt: get the resource from the class path. It
+ // may be the case that clazz was loaded by the Extentsion class
+ // loader which the parent of the system class loader. Hence the
+ // code below.
+ log.debug("Trying to find [" + resource + "] using ClassLoader.getSystemResource().");
+ return ClassLoader.getSystemResource(resource);
+ }
+
+
+ /**
+ * Gets the resource with the specified class loader.
+ *
+ * @param loader
+ * @param resource
+ * @return Returns URL.
+ * @throws ClassNotFoundException
+ */
+ static public URL getResource(ClassLoader loader, String resource) throws ClassNotFoundException {
+ URL url = null;
+ try {
+ if (loader != null) {
+ log.debug("Trying to find [" + resource + "] using " + loader + " class loader.");
+ url = loader.getResource(resource);
+ if (url != null) {
+ return url;
+ }
+ }
+ } catch (Throwable t) {
+ log.warn("Caught Exception while in Loader.getResource. This may be innocuous.", t);
+ }
+ return getResource(resource);
+ }
+
+ /**
+ * Gets the thread context class loader.
+ *
+ * @return Returns ClassLoader.
+ * @throws IllegalAccessException
+ * @throws InvocationTargetException
+ */
+ static public ClassLoader getTCL() throws IllegalAccessException, InvocationTargetException {
+ return Thread.currentThread().getContextClassLoader();
+ }
+
+ /**
+ * Loads the specified classloader and then falls back to the loadClass.
+ *
+ * @param loader
+ * @param clazz
+ * @return Returns Class.
+ * @throws ClassNotFoundException
+ */
+ static public Class loadClass(ClassLoader loader, String clazz) throws ClassNotFoundException {
+ try {
+ if(loader != null) {
+ Class c = loader.loadClass(clazz);
+ if (c != null)
+ return c;
+ }
+ } catch (Throwable e) {
+ }
+ return loadClass(clazz);
+ }
+
+ /**
+ * If running under JDK 1.2, loads the specified class using the
+ * <code>Thread</code> <code>contextClassLoader</code> . If that
+ * fails, try Class.forname.
+ * <p/>
+ *
+ * @param clazz
+ * @return Returns Class.
+ * @throws ClassNotFoundException
+ */
+ static public Class loadClass(String clazz) throws ClassNotFoundException {
+ try {
+ ClassLoader tcl = getTCL();
+
+ if(tcl != null) {
+ Class c = tcl.loadClass(clazz);
+ if (c != null)
+ return c;
+ }
+ } catch (Throwable e) {
+ }
+ // we reached here because tcl was null or because of a
+ // security exception, or because clazz could not be loaded...
+ // In any case we now try one more time
+ return Class.forName(clazz);
+ }
+}
Modified: webservices/axis2/trunk/java/modules/common/src/org/apache/axis2/util/XMLUtils.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/common/src/org/apache/axis2/util/XMLUtils.java?rev=366555&r1=366554&r2=366555&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/common/src/org/apache/axis2/util/XMLUtils.java (original)
+++ webservices/axis2/trunk/java/modules/common/src/org/apache/axis2/util/XMLUtils.java Fri Jan 6 11:46:16 2006
@@ -65,12 +65,12 @@
initSAXFactory(null, true, false);
}
- /** Encode a string appropriately for XML.
- *
+ /**
+ * Encodes a string appropriately for XML.
* Lifted from ApacheSOAP 2.2 (org.apache.soap.Utils)
*
* @param orig the String to encode
- * @return a String in which XML special chars are repalced by entities
+ * @return Returns a String in which XML special chars are repalced by entities.
*/
public static String xmlEncodeString(String orig)
{
@@ -127,7 +127,8 @@
return strBuf.toString();
}
- /** Initialize the SAX parser factory.
+ /**
+ * Initializes the SAX parser factory.
*
* @param factoryClassName The (optional) class name of the desired
* SAXParserFactory implementation. Will be
@@ -185,7 +186,8 @@
private static boolean tryReset= true;
- /** Return a SAX parser for reuse.
+ /**
+ * Returns a SAX parser for reuse.
* @param parser A SAX parser that is available for reuse
*/
public static void releaseSAXParser(SAXParser parser) {
@@ -207,8 +209,8 @@
}
}
/**
- * Get an empty new Document
- * @return Document
+ * Gets an empty new Document.
+ * @return Returns Document.
* @throws ParserConfigurationException if construction problems occur
*/
public static Document newDocument()
@@ -220,8 +222,8 @@
}
/**
- * Get a new Document read from the input source
- * @return Document
+ * Gets a new Document read from the input source.
+ * @return Returns Document.
* @throws ParserConfigurationException if construction problems occur
* @throws SAXException if the document has xml sax problems
* @throws IOException if i/o exceptions occur
@@ -239,8 +241,8 @@
}
/**
- * Get a new Document read from the input stream
- * @return Document
+ * Gets a new Document read from the input stream
+ * @return Returns Document.
* @throws ParserConfigurationException if construction problems occur
* @throws SAXException if the document has xml sax problems
* @throws IOException if i/o exceptions occur
@@ -252,8 +254,8 @@
}
/**
- * Get a new Document read from the indicated uri
- * @return Document
+ * Gets a new Document read from the indicated uri
+ * @return Returns Document.
* @throws ParserConfigurationException if construction problems occur
* @throws SAXException if the document has xml sax problems
* @throws IOException if i/o exceptions occur
@@ -267,7 +269,7 @@
}
/**
- * Create a new document from the given URI, use the username and password
+ * Creates a new document from the given URI. Uses the username and password
* if the URI requires authentication.
* @param uri the resource to get
* @param username basic auth username
@@ -319,10 +321,10 @@
}
/**
- * Return a QName when passed a string like "foo:bar" by mapping
+ * Returns a QName when passed a string like "foo:bar" by mapping
* the "foo" prefix to a namespace in the context of the given Node.
*
- * @return a QName generated from the given string representation
+ * @return Returns a QName generated from the given string representation.
*/
public static QName getQNameFromString(String str, Node e) {
if (str == null || e == null)
@@ -341,7 +343,7 @@
}
/**
- * Return a string for a particular QName, mapping a new prefix
+ * Returns a string for a particular QName, mapping a new prefix
* if necessary.
*/
public static String getStringForQName(QName qname, Element e)
@@ -362,13 +364,13 @@
}
/**
- * Concat all the text and cdata node children of this elem and return
+ * Concatinates all the text and cdata node children of this elem and returns
* the resulting text.
* (by Matt Duftler)
*
* @param parentEl the element whose cdata/text node values are to
* be combined.
- * @return the concatanated string.
+ * @return Returns the concatinated string.
*/
public static String getChildCharacterData (Element parentEl) {
if (parentEl == null) {
@@ -429,7 +431,6 @@
* use getInputSourceFromURI(uri, username, password)
*
* @param uri the resource to get
- * @see #getInputSourceFromURI(String uri, String username, String password)
*/
public static InputSource getInputSourceFromURI(String uri) {
return new InputSource(uri);
@@ -440,12 +441,12 @@
/**
* Utility to get the bytes at a protected uri
*
- * This will retrieve the URL if a username and password are provided.
+ * Retrieves the URL if a username and password are provided.
* The java.net.URL class does not do Basic Authentication, so we have to
* do it manually in this routine.
*
- * If no username is provided, we create an InputSource from the uri
- * and let the InputSource go fetch the contents.
+ * If no username is provided, creates an InputSource from the uri
+ * and lets the InputSource go fetch the contents.
*
* @param uri the resource to get
* @param username basic auth username
@@ -519,11 +520,11 @@
}
/**
- * Find a Node with a given QNameb
+ * Finds a Node with a given QNameb.
*
* @param node parent node
* @param name QName of the child we need to find
- * @return child node
+ * @return Returns child node.
*/
public static Node findNode(Node node, QName name){
if(name.getNamespaceURI().equals(node.getNamespaceURI()) &&
Modified: webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/client/Call.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/client/Call.java?rev=366555&r1=366554&r2=366555&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/client/Call.java (original)
+++ webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/client/Call.java Fri Jan 6 11:46:16 2006
@@ -58,7 +58,7 @@
}
/**
- * This is used to create call object with client home.
+ * Creates call object with client home.
*
* @param clientHome
* @throws AxisFault
@@ -116,11 +116,11 @@
/**
* Invokes the blocking/synchronous call.
- * s
+ *
*
* @param axisop - this is used to identify the operation on the client side explicitly.
* @param toSend - data to be sent (OMElement).
- * @return
+ * @return Returns OMElement.
* @throws AxisFault
*/
public OMElement invokeBlocking(String axisop, OMElement toSend) throws AxisFault {
@@ -140,11 +140,11 @@
}
/**
- * Invokes the blocking/synchronous call
+ * Invokes the blocking/synchronous call.
*
* @param axisop - this is used to identify the operation on the client side explicitly.
* @param envelope - data to be sent (SOAPEnvelope).
- * @return
+ * @return Returns SOAPEnvelope.
* @throws AxisFault
*/
public SOAPEnvelope invokeBlocking(String axisop, SOAPEnvelope envelope) throws AxisFault {
@@ -167,7 +167,7 @@
}
/**
- * Invokes the nonblocking/asynchronous call
+ * Invokes the nonblocking/asynchronous call.
*
* @param axisop
* @param toSend - data to be sent (OMElement).
@@ -188,7 +188,7 @@
}
/**
- * Invokes the nonblocking/asynchronous call
+ * Invokes the nonblocking/asynchronous call.
*
* @param axisop
* @param envelope - data to be sent (SOAPEnvelope).
@@ -216,9 +216,9 @@
}
/**
- * Get the MessageContext of the response
+ * Get the MessageContext of the response.
*
- * @return message context
+ * @return Returns message context.
*/
public MessageContext getResponseMessageContext() {
return lastResponseMsgCtx;
Modified: webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/client/InOutMEPClient.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/client/InOutMEPClient.java?rev=366555&r1=366554&r2=366555&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/client/InOutMEPClient.java (original)
+++ webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/client/InOutMEPClient.java Fri Jan 6 11:46:16 2006
@@ -358,11 +358,11 @@
}
/**
- * Sends the message using a two way transport and waits for a response
+ * Sends the message using a two way transport and waits for a response.
*
* @param msgctx
* @param transportIn
- * @return
+ * @return Returns MessageContext.
* @throws AxisFault
*/
public MessageContext send(MessageContext msgctx, TransportInDescription transportIn)
Modified: webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/client/MEPClient.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/client/MEPClient.java?rev=366555&r1=366554&r2=366555&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/client/MEPClient.java (original)
+++ webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/client/MEPClient.java Fri Jan 6 11:46:16 2006
@@ -43,7 +43,7 @@
import java.util.List;
/**
- * This is the super class for all the MEPClients.
+ * This is the super class for all MEPClients.
*/
public abstract class MEPClient {
private static final String ANONYMOUS_SERVICE = "AnonymousService";
@@ -149,9 +149,9 @@
}
/**
- * This will give chance to the derived class to configure his transport
- * from the information injected by the user via options. This will be
- * called within the prepare invocation method, so user should not bother to
+ * This gives chance to the derived class to configure its transport
+ * from the information injected by the user via options. This is
+ * called within the prepare invocation method, so user does not need to
* call this explicitly.
*/
protected abstract void configureTransportInformation(MessageContext msgCtxt) throws AxisFault;
@@ -159,7 +159,7 @@
/**
* Creates SOAPEvelope(in terms of version) from the values set.
*
- * @return
+ * @return Returns SOAPEnvelope.
* @throws AxisFault
*/
protected SOAPEnvelope createDefaultSOAPEnvelope() throws AxisFault {
@@ -223,7 +223,7 @@
* mail:// local://.
*
* @param epr
- * @return
+ * @return Returns TransportOutDescription.
* @throws AxisFault
*/
protected TransportOutDescription inferTransport(EndpointReference epr) throws AxisFault {
@@ -343,7 +343,7 @@
* Prepares the SOAPEnvelope using the payload.
*
* @param toSend
- * @return
+ * @return Returns MessageContext.
* @throws AxisFault
*/
protected MessageContext prepareTheSOAPEnvelope(OMElement toSend) throws AxisFault {
@@ -379,8 +379,7 @@
}
/**
- * User will set all the options and parameters for this invocation using
- * this.
+ * Sets all client options and parameters for this invocation.
*
* @param clientOptions
* @see Options for more details.
Modified: webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/context/ConfigurationContextFactory.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/context/ConfigurationContextFactory.java?rev=366555&r1=366554&r2=366555&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/context/ConfigurationContextFactory.java (original)
+++ webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/context/ConfigurationContextFactory.java Fri Jan 6 11:46:16 2006
@@ -25,13 +25,13 @@
private Log log = LogFactory.getLog(getClass());
/**
- * To create a AxisConfiguration depending on the user requiremnt , this method can be used.
- * First create a AxisConfigurator object giving necessary parameters into it.
- * Depending on the implementation getAxisConfiguration(); will give the AxisConfiguration and
- * using the ConfigurationContext will be created and return that.
+ * Creates a AxisConfiguration depending on the user requirment.
+ * First creates an AxisConfigurator object with appropriate parameters.
+ * Depending on the implementation getAxisConfiguration(), gets
+ * the AxisConfiguration and uses it to create the ConfigurationContext.
*
* @param axisConfigurator
- * @return
+ * @return Returns ConfigurationContext.
* @throws AxisFault
*/
public ConfigurationContext createConfigurationContext(
@@ -43,7 +43,7 @@
}
/**
- * Builds the configuration
+ * Builds the configuration.
*
* @param path
* @return Returns the built ConfigurationContext.
@@ -54,7 +54,7 @@
}
/**
- * To initilizae modules and , create Tranpsorts, this method is bean used
+ * Initializes modules and creates Transports.
*/
private void init(ConfigurationContext configContext) throws AxisFault {
@@ -143,10 +143,9 @@
}
/**
- * To get the default configuration context , this will return a AxisConfiguration
- * which is created by fileSystem based AxisConfiguration creator
+ * Gets the default configuration context by using the file system based AxisConfiguration.
*
- * @return ConfigurationContext
+ * @return Returns ConfigurationContext.
*/
public ConfigurationContext createEmptyConfigurationContext() {
return new ConfigurationContext(new AxisConfiguration());
Modified: webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/context/OperationContext.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/context/OperationContext.java?rev=366555&r1=366554&r2=366555&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/context/OperationContext.java (original)
+++ webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/context/OperationContext.java Fri Jan 6 11:46:16 2006
@@ -120,7 +120,7 @@
/**
* Returns the EngineContext in which the parent ServiceContext lives.
*
- * @return parent ServiceContext's parent EngineContext
+ * @return Returns parent ServiceContext's parent EngineContext.
*/
public ConfigurationContext getEngineContext() {
return ((ServiceContext) parent).getConfigurationContext();
@@ -128,7 +128,7 @@
/**
* @param messageLabel
- * @return
+ * @return Returns MessageContext.
* @throws AxisFault
*/
public MessageContext getMessageContext(String messageLabel) throws AxisFault {
@@ -142,7 +142,7 @@
/**
* Returns the ServiceContext in which this OperationContext lives.
*
- * @return parent ServiceContext
+ * @return Returns parent ServiceContext.
*/
public ServiceContext getServiceContext() {
return (ServiceContext) parent;
Modified: webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/context/ServiceGroupContext.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/context/ServiceGroupContext.java?rev=366555&r1=366554&r2=366555&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/context/ServiceGroupContext.java (original)
+++ webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/context/ServiceGroupContext.java Fri Jan 6 11:46:16 2006
@@ -46,12 +46,12 @@
}
/**
- * At each time you ask for a service context this will create a new one by
- * passing AxisService into it , and no need to store service context inside serviceGroup
- * context as well
+ * Gets a service context. Creates a new one from AxisService.
+ * There is no need to store service context inside serviceGroup
+ * context as well.
*
* @param service
- * @return
+ * @return Returns ServiceContext.
* @throws AxisFault
*/
public ServiceContext getServiceContext(AxisService service) throws AxisFault {
Modified: webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/deployment/AxisServiceBuilder.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/deployment/AxisServiceBuilder.java?rev=366555&r1=366554&r2=366555&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/deployment/AxisServiceBuilder.java (original)
+++ webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/deployment/AxisServiceBuilder.java Fri Jan 6 11:46:16 2006
@@ -250,7 +250,7 @@
// wsdl:Binding -> wsdl:Operation
operationPolicies = getPoliciesAsExtElements(wsdl4jBindingOperation
.getExtensibilityElements());
- addPolicyElements(PolicyInclude.BINDING_OPERATOIN_POLICY,
+ addPolicyElements(PolicyInclude.BINDING_OPERATION_POLICY,
operationPolicies, operationPolicyInclude);
axisOperation.setPolicyInclude(operationPolicyInclude);
Modified: webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/deployment/repository/util/ArchiveReader.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/deployment/repository/util/ArchiveReader.java?rev=366555&r1=366554&r2=366555&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/deployment/repository/util/ArchiveReader.java (original)
+++ webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/deployment/repository/util/ArchiveReader.java Fri Jan 6 11:46:16 2006
@@ -82,7 +82,7 @@
try {
Utils.fillAxisService(service,axisConfig);
} catch (Exception e) {
- log.info("Error in scheam generating :" + e.getMessage());
+ log.info("Error in schema generating :" + e.getMessage());
}
}
serviceList.add(service);
@@ -181,7 +181,7 @@
}
/**
- * Extract Service XML files and builds the service groups
+ * Extracts Service XML files and builds the service groups.
*
* @param filename
* @param engine
@@ -189,7 +189,7 @@
* @param extractService
* @param wsdls
* @param axisConfig
- * @return
+ * @return Returns ArrayList.
* @throws DeploymentException
*/
public ArrayList processServiceGroup(String filename, DeploymentEngine engine,
Modified: webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/description/ParameterImpl.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/description/ParameterImpl.java?rev=366555&r1=366554&r2=366555&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/description/ParameterImpl.java (original)
+++ webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/description/ParameterImpl.java Fri Jan 6 11:46:16 2006
@@ -52,13 +52,13 @@
private Object value;
/**
- * Constructor ParameterImpl
+ * Constructor ParameterImpl.
*/
public ParameterImpl() {
}
/**
- * Constructor ParameterImpl
+ * Constructor ParameterImpl.
*
* @param name
* @param value
@@ -69,9 +69,9 @@
}
/**
- * Method getName
+ * Method getName.
*
- * @return
+ * @return Returns String.
*/
public String getName() {
return name;
@@ -82,34 +82,34 @@
}
/**
- * Method getParameterType
+ * Method getParameterType.
*
- * @return
+ * @return Returns int.
*/
public int getParameterType() {
return type;
}
/**
- * Method getValue
+ * Method getValue.
*
- * @return
+ * @return Returns Object.
*/
public Object getValue() {
return value;
}
/**
- * Method isLocked
+ * Method isLocked.
*
- * @return
+ * @return Returns boolean.
*/
public boolean isLocked() {
return locked;
}
/**
- * Method setLocked
+ * Method setLocked.
*
* @param value
*/
@@ -118,7 +118,7 @@
}
/**
- * Method setName
+ * Method setName.
*
* @param name
*/
@@ -135,7 +135,7 @@
}
/**
- * Method setValue
+ * Method setValue.
*
* @param value
*/
Modified: webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/description/ParameterIncludeImpl.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/description/ParameterIncludeImpl.java?rev=366555&r1=366554&r2=366555&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/description/ParameterIncludeImpl.java (original)
+++ webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/description/ParameterIncludeImpl.java Fri Jan 6 11:46:16 2006
@@ -39,7 +39,7 @@
protected final HashMap parameters;
/**
- * Constructor ParameterIncludeImpl
+ * Constructor ParameterIncludeImpl.
*/
public ParameterIncludeImpl() {
parameters = new HashMap();
@@ -57,7 +57,7 @@
}
/**
- * At the run time it can be able to change parameters , and system can save at any time and
+ * Since at runtime it parameters may be modified
* to get the original state this method can be used
*
* @param parameters <code>OMElement</code>
@@ -114,10 +114,10 @@
}
/**
- * Method getParameter
+ * Method getParameter.
*
* @param name
- * @return parameter
+ * @return Returns parameter.
*/
public Parameter getParameter(String name) {
return (Parameter) parameters.get(name);
Modified: webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/description/PhaseRule.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/description/PhaseRule.java?rev=366555&r1=366554&r2=366555&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/description/PhaseRule.java (original)
+++ webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/description/PhaseRule.java Fri Jan 6 11:46:16 2006
@@ -48,7 +48,7 @@
private String phaseName;
/**
- * Constructor PhaseRule
+ * Constructor PhaseRule.
*/
public PhaseRule() {
this.before = "";
@@ -63,52 +63,52 @@
}
/**
- * Method getAfter
+ * Method getAfter.
*
- * @return
+ * @return Returns String.
*/
public String getAfter() {
return after;
}
/**
- * Method getBefore
+ * Method getBefore.
*
- * @return
+ * @return Returns String.
*/
public String getBefore() {
return before;
}
/**
- * Method getPhaseName
+ * Method getPhaseName.
*
- * @return
+ * @return Returns String.
*/
public String getPhaseName() {
return phaseName;
}
/**
- * Method isPhaseFirst
+ * Method isPhaseFirst.
*
- * @return
+ * @return Returns boolean.
*/
public boolean isPhaseFirst() {
return phaseFirst;
}
/**
- * Method isPhaseLast
+ * Method isPhaseLast.
*
- * @return
+ * @return Returns boolean.
*/
public boolean isPhaseLast() {
return phaseLast;
}
/**
- * Method setAfter
+ * Method setAfter.
*
* @param after
*/
@@ -117,7 +117,7 @@
}
/**
- * Method setBefore
+ * Method setBefore.
*
* @param before
*/
@@ -126,7 +126,7 @@
}
/**
- * Method setPhaseFirst
+ * Method setPhaseFirst.
*
* @param phaseFirst
*/
@@ -135,7 +135,7 @@
}
/**
- * Method setPhaseLast
+ * Method setPhaseLast.
*
* @param phaseLast
*/
@@ -144,7 +144,7 @@
}
/**
- * Method setPhaseName
+ * Method setPhaseName.
*
* @param phaseName
*/
Modified: webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/description/PolicyInclude.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/description/PolicyInclude.java?rev=366555&r1=366554&r2=366555&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/description/PolicyInclude.java (original)
+++ webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/description/PolicyInclude.java Fri Jan 6 11:46:16 2006
@@ -47,7 +47,7 @@
public static final int OPERATION_POLICY = 7;
- public static final int BINDING_OPERATOIN_POLICY = 8;
+ public static final int BINDING_OPERATION_POLICY = 8;
public static final int INPUT_POLICY = 9;
Modified: webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/description/TransportInDescription.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/description/TransportInDescription.java?rev=366555&r1=366554&r2=366555&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/description/TransportInDescription.java (original)
+++ webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/description/TransportInDescription.java Fri Jan 6 11:46:16 2006
@@ -27,7 +27,7 @@
import java.util.ArrayList;
/**
- * Represents a incoming transport deployed in AXis2
+ * Represents an incoming transport deployed in Axis2.
*/
public class TransportInDescription implements ParameterInclude {
@@ -36,14 +36,10 @@
*/
private Flow faultFlow;
- // to store handler Fault in inFlow
+ // Stores handler Fault in inFlow
private Phase faultPhase;
- /**
- * Field phasesInclude
- */
-
- /**
+ /**
* Field flowInclude
*/
private Flow inFlow;
@@ -63,7 +59,7 @@
protected TransportListener receiver;
/**
- * Constructor AxisTransport
+ * Constructor AxisTransport.
*
* @param name
*/
@@ -75,7 +71,7 @@
}
/**
- * Method addParameter
+ * Method addParameter.
*
* @param param
*/
@@ -104,17 +100,17 @@
}
/**
- * @return
+ * @return Returns QName.
*/
public QName getName() {
return name;
}
/**
- * Method getParameter
+ * Method getParameter.
*
* @param name
- * @return
+ * @return Returns Parameter.
*/
public Parameter getParameter(String name) {
return paramInclude.getParameter(name);
@@ -125,7 +121,7 @@
}
/**
- * @return
+ * @return Returns TransportListener.
*/
public TransportListener getReceiver() {
return receiver;
Modified: webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/description/TransportOutDescription.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/description/TransportOutDescription.java?rev=366555&r1=366554&r2=366555&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/description/TransportOutDescription.java (original)
+++ webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/description/TransportOutDescription.java Fri Jan 6 11:46:16 2006
@@ -43,7 +43,7 @@
protected QName name;
/**
- * Field flowInclude
+ * Field outFlow
*/
private Flow outFlow;
private Phase outPhase;
@@ -55,7 +55,7 @@
protected TransportSender sender;
/**
- * Constructor AxisTransport
+ * Constructor AxisTransport.
*
* @param name
*/
@@ -67,7 +67,7 @@
}
/**
- * Method addParameter
+ * Method addParameter.
*
* @param param
*/
@@ -88,7 +88,7 @@
}
/**
- * @return
+ * @return Returns QName.
*/
public QName getName() {
return name;
@@ -103,10 +103,10 @@
}
/**
- * Method getParameter
+ * Method getParameter.
*
* @param name
- * @return
+ * @return Returns Parameter.
*/
public Parameter getParameter(String name) {
return paramInclude.getParameter(name);
@@ -117,7 +117,7 @@
}
/**
- * @return
+ * @return Returns TransportSender.
*/
public TransportSender getSender() {
return sender;
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=366555&r1=366554&r2=366555&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 Fri Jan 6 11:46:16 2006
@@ -91,7 +91,7 @@
private ClassLoader systemClassLoader;
/**
- * Constructor AxisConfigurationImpl
+ * Constructor AxisConfigurationImpl.
*/
public AxisConfiguration() {
moduleConfigmap = new HashMap();
@@ -290,9 +290,9 @@
}
/**
- * This will engage the default module version corresponding to given module name , or if the module
- * name contains version numbre init then it will engage the corret module ,therefore both of the
- * following two cases are valid
+ * Engages the default module version corresponding to given module name , or if the module
+ * name contains version number in it then it will engage the correct module.
+ * Both of the below two cases are valid
* 1. engageModule("addressing");
* 2. engageModule("addressing-1.23");
*
@@ -316,7 +316,7 @@
}
/**
- * Engagging a module using give name and its version ID
+ * Engages a module using give name and its version ID.
*
* @param moduleName
* @param versionID
@@ -356,11 +356,11 @@
}
/**
- * This method is used to load module from class path , the mar files in a jar file inside
+ * Loads module from class path - the mar files in a jar file inside
* modules/ directory
*
* @param moduleName
- * @return
+ * @return Returns ModuleDescription.
* @throws AxisFault
*/
public ModuleDescription loadModulefromResources(String moduleName) throws AxisFault {
@@ -427,7 +427,7 @@
}
/**
- * @return Returns ArrayList
+ * @return Returns ArrayList.
*/
public ArrayList getInFaultFlow() {
return inFaultPhases;
@@ -490,7 +490,7 @@
}
/**
- * @return Returns ArrayList
+ * @return Returns ArrayList.
*/
public ArrayList getOutFaultFlow() {
return outFaultPhases;
@@ -500,7 +500,7 @@
* Method getParameter.
*
* @param name
- * @return Returns Parameter
+ * @return Returns Parameter.
*/
public Parameter getParameter(String name) {
return paramInclude.getParameter(name);
@@ -588,7 +588,7 @@
* Checks whether a given parameter is locked.
*
* @param parameterName
- * @return Returns boolean
+ * @return Returns boolean.
*/
public boolean isParameterLocked(String parameterName) {
Parameter parameter = getParameter(parameterName);
@@ -665,9 +665,9 @@
}
/**
- * To add a dafault module version , which can either done by programatically or using
- * axis2.xml , and the dafault module version is important if user ask to engage a module without
- * given version ID , in that case we will engage the dafault version
+ * Adds a dafault module version , which can be done either programatically or by using
+ * axis2.xml . The default module version is important if user asks to engage
+ * a module without given version ID, in which case, we will engage the default version.
*
* @param moduleName
* @param moduleVersion
Modified: webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/fault/FaultSubcode.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/fault/FaultSubcode.java?rev=366555&r1=366554&r2=366555&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/fault/FaultSubcode.java (original)
+++ webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/fault/FaultSubcode.java Fri Jan 6 11:46:16 2006
@@ -39,13 +39,13 @@
private QName value;
/**
- * simple constructor
+ * Simple constructor.
*/
public FaultSubcode() {
}
/**
- * Recursively construct from fault information
+ * Recursively construct from fault information.
*
* @param source
*/
@@ -70,7 +70,7 @@
}
/**
- * Constructor to fill in subcodes
+ * Constructor to fill in subcodes.
*
* @param value fault value (may be null)
* @param subcode fault subcode (may be null)
@@ -81,10 +81,9 @@
}
/**
- * Returns a string representation of the object.
- * This only stringifies the base fault
+ * Returns a string representation of the object (base fault).
*
- * @return a string representation of the object.
+ * @return Returns a string representation of the object.
*/
public String toString() {
return (value != null)
@@ -93,16 +92,16 @@
}
/**
- * Get the current failt code value
+ * Gets the current failt code value.
*
- * @return
+ * @return Returns QName.
*/
public QName getValue() {
return value;
}
/**
- * set the value of the fault code
+ * Sets the value of the fault code.
*
* @param value new value
*/
Modified: webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/handlers/AbstractHandler.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/handlers/AbstractHandler.java?rev=366555&r1=366554&r2=366555&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/handlers/AbstractHandler.java (original)
+++ webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/handlers/AbstractHandler.java Fri Jan 6 11:46:16 2006
@@ -42,14 +42,14 @@
protected HandlerDescription handlerDesc;
/**
- * Constructor AbstractHandler
+ * Constructor AbstractHandler.
*/
public AbstractHandler() {
handlerDesc = EMPTY_HANDLER_METADATA;
}
/**
- * Method cleanup
+ * Method cleanup.
*
* @throws AxisFault
*/
@@ -57,7 +57,7 @@
}
/**
- * Method init
+ * Method init.
*
* @param handlerdesc
*/
@@ -66,7 +66,7 @@
}
/**
- * Method revoke
+ * Method revoke.
*
* @param msgContext
*/
@@ -86,29 +86,28 @@
}
/**
- * To get the phaseRule of a handler it is required to get the HnadlerDescription of the handler
- * so the argumnet pass when it call return as HnadlerDescription
+ * Gets the phaseRule of a handler.
*
- * @return
+ * @return Returns HandlerDescription.
*/
public HandlerDescription getHandlerDesc() {
return handlerDesc;
}
/**
- * Method getName
+ * Method getName.
*
- * @return
+ * @return Returns QName.
*/
public QName getName() {
return handlerDesc.getName();
}
/**
- * Method getParameter
+ * Method getParameter.
*
* @param name
- * @return
+ * @return Returns Parameter.
*/
public Parameter getParameter(String name) {
return handlerDesc.getParameter(name);
Modified: webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/receivers/AbstractMessageReceiver.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/receivers/AbstractMessageReceiver.java?rev=366555&r1=366554&r2=366555&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/receivers/AbstractMessageReceiver.java (original)
+++ webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/receivers/AbstractMessageReceiver.java Fri Jan 6 11:46:16 2006
@@ -34,10 +34,10 @@
public static final String SCOPE = "scope";
/**
- * Method makeNewServiceObject
+ * Method makeNewServiceObject.
*
* @param msgContext
- * @return
+ * @return Returns Object.
* @throws AxisFault
*/
protected Object makeNewServiceObject(MessageContext msgContext) throws AxisFault {
@@ -72,10 +72,10 @@
}
/**
- * Method getTheImplementationObject
+ * Method getTheImplementationObject.
*
* @param msgContext
- * @return
+ * @return Returns Object.
* @throws AxisFault
*/
protected Object getTheImplementationObject(MessageContext msgContext) throws AxisFault {
Modified: webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/transport/http/HTTPConstants.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/transport/http/HTTPConstants.java?rev=366555&r1=366554&r2=366555&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/transport/http/HTTPConstants.java (original)
+++ webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/transport/http/HTTPConstants.java Fri Jan 6 11:46:16 2006
@@ -119,22 +119,22 @@
public static final byte NOCONTENT[] = ("202 OK\n\n").getBytes();
/**
- * String
+ * Field MC_HTTP_STATUS_MESSAGE
*/
public static String MC_HTTP_STATUS_MESSAGE = "transport.http.statusMessage";
/**
- * Integer
+ * Field MC_HTTP_STATUS_CODE
*/
public static String MC_HTTP_STATUS_CODE = "transport.http.statusCode";
/**
- * HttpServletResponse
+ * Field MC_HTTP_SERVLETRESPONSE
*/
public static String MC_HTTP_SERVLETRESPONSE = "transport.http.servletResponse";
/**
- * HttpServletRequest
+ * Field MC_HTTP_SERVLETREQUEST
*/
public static String MC_HTTP_SERVLETREQUEST = "transport.http.servletRequest";
@@ -149,7 +149,7 @@
public static String MC_HTTP_SERVLETLOCATION = "transport.http.servletLocation";
/**
- * HttpServlet
+ * Field MC_HTTP_SERVLET
*/
public static String MC_HTTP_SERVLET = "transport.http.servlet";
@@ -246,7 +246,7 @@
public static final String HEADER_EXPECT = "Expect";
/**
- * HTTP header field values
+ * Field HEADER_DEFAULT_CHAR_ENCODING
*/
public static final String HEADER_DEFAULT_CHAR_ENCODING = "iso-8859-1";
@@ -256,7 +256,7 @@
public static final String HEADER_COOKIE2 = "Cookie2";
/**
- * Cookie headers
+ * Field HEADER_COOKIE
*/
public static final String HEADER_COOKIE = "Cookie";
@@ -408,10 +408,10 @@
public static final String CONNECTION_TIMEOUT = "CONNECTION_TIMEOUT";
/**
- * Method getBytes
+ * Method getBytes.
*
* @param data
- * @return
+ * @return Returns byte[].
*/
public static byte[] getBytes(final String data) {
if (data == null) {
Modified: webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/transport/http/HTTPTransportReceiver.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/transport/http/HTTPTransportReceiver.java?rev=366555&r1=366554&r2=366555&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/transport/http/HTTPTransportReceiver.java (original)
+++ webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/transport/http/HTTPTransportReceiver.java Fri Jan 6 11:46:16 2006
@@ -38,14 +38,14 @@
public class HTTPTransportReceiver {
/**
- * Field BEFORE_SEPERATOR
+ * Field BEFORE_SEPARATOR
*/
- private static final int BEFORE_SEPERATOR = 3;
+ private static final int BEFORE_SEPARATOR = 3;
/**
- * Field AFTER_SEPERATOR
+ * Field AFTER_SEPARATOR
*/
- private static final int AFTER_SEPERATOR = 4;
+ private static final int AFTER_SEPARATOR = 4;
/**
* Field lastRead
@@ -73,7 +73,7 @@
private boolean done = false;
/**
- * parses following two styles of HTTP stuff
+ * Parses following two styles of HTTP stuff
* Server Side
* POST /axis2/services/echo HTTP/1.0
* Content-Type: text/xml; charset=utf-8
@@ -92,7 +92,7 @@
*
* @param in
* @param serverSide
- * @return
+ * @return Returns HashMap.
* @throws AxisFault
*/
public HashMap parseTheHeaders(InputStream in, boolean serverSide) throws AxisFault {
@@ -100,7 +100,7 @@
try {
StringBuffer str = new StringBuffer();
- int state = BEFORE_SEPERATOR;
+ int state = BEFORE_SEPARATOR;
String key = null;
String value = null;
@@ -138,7 +138,7 @@
map.put(HTTPConstants.RESPONSE_WORD, value);
}
- state = BEFORE_SEPERATOR;
+ state = BEFORE_SEPARATOR;
while (!done) {
length = readLine(in, buf);
@@ -149,11 +149,11 @@
for (int i = 0; i < length; i++) {
switch (state) {
- case BEFORE_SEPERATOR :
+ case BEFORE_SEPARATOR :
if (buf[i] == ':') {
key = str.toString();
str = new StringBuffer();
- state = AFTER_SEPERATOR;
+ state = AFTER_SEPARATOR;
if (buf[i + 1] == ' ') {
i++; // ignore next space
@@ -164,7 +164,7 @@
break;
- case AFTER_SEPERATOR :
+ case AFTER_SEPARATOR :
if (buf[i] == '\n') {
value = str.toString();
map.put(key, value);
@@ -181,7 +181,7 @@
}
}
- state = BEFORE_SEPERATOR;
+ state = BEFORE_SEPARATOR;
}
} catch (IOException e) {
throw new AxisFault(e.getMessage(), e);
@@ -191,10 +191,10 @@
}
/**
- * Method readFirstLineArg
+ * Method readFirstLineArg.
*
* @param terminal
- * @return
+ * @return Returns String.
* @throws org.apache.axis2.AxisFault
*/
private String readFirstLineArg(char terminal) throws AxisFault {
@@ -215,11 +215,11 @@
}
/**
- * Read a single line from the input stream
+ * Reads a single line from the input stream.
*
* @param is inputstream to read from
* @param b byte array to read into
- * @return
+ * @return Returns int.
* @throws java.io.IOException
*/
protected int readLine(InputStream is, byte[] b) throws java.io.IOException {
@@ -314,11 +314,11 @@
}
/**
- * Returns the HTML text for the list of services deployed
+ * Returns the HTML text for the list of services deployed.
* This can be delegated to another Class as well
- * where it will handle more options of GET messages :-?
+ * where it will handle more options of GET messages.
*
- * @return
+ * @return Returns String.
*/
public static String getServicesHTML(ConfigurationContext configurationContext) {
String temp = "";
Modified: webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/transport/http/server/SimpleHttpServerConnection.java
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/transport/http/server/SimpleHttpServerConnection.java?rev=366555&r1=366554&r2=366555&view=diff
==============================================================================
--- webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/transport/http/server/SimpleHttpServerConnection.java (original)
+++ webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/transport/http/server/SimpleHttpServerConnection.java Fri Jan 6 11:46:16 2006
@@ -261,7 +261,7 @@
/**
* Returns the ResponseWriter used to write the output to the socket.
*
- * @return This connection's ResponseWriter
+ * @return Returns this connection's ResponseWriter.
*/
public ResponseWriter getWriter() throws UnsupportedEncodingException {
return new ResponseWriter(out);
@@ -302,7 +302,7 @@
* - Improve this logic to genaralize it a bit more
* - Obtain the ip to be used here from the Call API
*
- * @return
+ * @return Returns String.
* @throws SocketException
*/
public static String getIpAddress() throws SocketException {