org.iids.aos.webservices.axisstub.aosrpc
Class AOSURLParser

java.lang.Object
  org.iids.aos.webservices.axisstub.aosrpc.AOSURLParser

public class AOSURLParser
extends java.lang.Object

A utility for parsing AOS URLs. An AOS URL is formatted as follows: aosrpc:url=;wsdl_port= where the ';'-separated components may appear in any order. is the name of the WSDL port that the operation resides in, encoded. is currently not supported. It is the location where the Web service resides (typically an http URL) in encoded form. It is optional. If omitted, the URL specified by the WSDL port is used. The encoding used by the components is as follows: '%' -> '%25' ';' -> '%3B' '=' -> '%3D' Note that we use the 'opaque' URL format in RFC 2396, which requires that the first character following 'aosrpc:' is not a slash. At first glance, I don't think there are illegal characters in the opaque part (apart from the first character) that aren't also illegal in the hierarchical URL form, but I should check more thoroughly. The encoding I introduce above exists merely so that we can define our own structure within the opaque part.

Nested Class Summary

static class	AOSURLParser.AOSURLException Exception thrown on parse errors.
static class	AOSURLParser.ParsedAOSURL Parsed components of the AOS URL.

Field Summary

static java.lang.String	PORT_COMPONENT_NAME
static java.lang.String	SCHEME
static java.lang.String	URL_COMPONENT_NAME

Constructor Summary

AOSURLParser()

Method Summary

static java.lang.String	decode(java.lang.String str) Performs URL '%HH' decoding of a String.
static java.lang.String	encode(java.lang.String str) Performs the URL encoding of a String, as specified above.
static void	main(java.lang.String[] argv) Test this class.
static AOSURLParser.ParsedAOSURL	parse(java.lang.String aosURL) Parses an AOS URL.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

SCHEME

public static final java.lang.String SCHEME

See Also:

Constant Field Values

URL_COMPONENT_NAME

public static final java.lang.String URL_COMPONENT_NAME

See Also:

Constant Field Values

PORT_COMPONENT_NAME

public static final java.lang.String PORT_COMPONENT_NAME

See Also:

Constant Field Values

Constructor Detail

AOSURLParser

public AOSURLParser()

Method Detail

parse

public static AOSURLParser.ParsedAOSURL parse(java.lang.String aosURL)
                                       throws AOSURLParser.AOSURLException

Parses an AOS URL.

Throws:

AOSURLParser.AOSURLException

encode

public static java.lang.String encode(java.lang.String str)

Performs the URL encoding of a String, as specified above.

decode

public static java.lang.String decode(java.lang.String str)
                               throws AOSURLParser.AOSURLException

Performs URL '%HH' decoding of a String.

Throws:

AOSURLParser.AOSURLException - on decoding error

main

public static void main(java.lang.String[] argv)
                 throws java.lang.Exception

Test this class.

Throws:

java.lang.Exception