Object representation and parsing of Uno Urls, which allow to locate a named Uno object in a different process. A Uno Url consists of the specification of a connection, protocol and rootOid delimited with a ';'. The syntax of a Uno Url is


[uno:]connection-type,parameters;protocol-name,parameters;objectname";

An example Uno Url will look like this:


socket,host=localhost,port=2002;urp;StarOffice.ServiceManager

For more information about Uno Url please consult http://udk.openoffice.org/common/man/spec/uno-url.html Usage:


  UnoUrl url = UnoUrl.parseUnoUrl("uno:socket,host=localhost,port=2002;urp;StarOffice.ServiceManager");

Nested and Inner Type Summary

Modifier and Type	Class and Description
private static class	UnoUrl.UnoUrlPart

Field Summary

Modifier and Type	Field and Description
private final UnoUrl.UnoUrlPart	connection
private static final String	FORMAT_ERROR
private static final String	OID_CHAR_SET
private final UnoUrl.UnoUrlPart	protocol
private final String	rootOid
private static final String	VALUE_CHAR_SET

Constructor Summary

Access	Constructor and Description
private	UnoUrl(UnoUrl.UnoUrlPart connectionPart, UnoUrl.UnoUrlPart protocolPart, String rootOid)

Method Summary

Modifier and Type	Method and Description
private static HashMap<String, String>	buildParamHashMap(String paramString)
private static String	decodeUTF8(String s)
public String	Returns: The connection name as string. getConnection() Returns the name of the connection of this Uno Url.
public String	Returns: The uninterpreted connection name and parameters as string. getConnectionAndParametersAsString() Returns the raw specification of the connection name and parameters.
public HashMap<String, String>	Returns: a HashMap with key/value pairs for connection parameters. getConnectionParameters() Returns the connection parameters as a Hashmap with key/value pairs.
public String	Returns: The uninterpreted connection parameters as string. getConnectionParametersAsString() Returns the raw specification of the connection parameters.
public String	Returns: The protocol name as string. getProtocol() Returns the name of the protocol of this Uno Url.
public String	Returns: The uninterpreted protocol name and parameters as string. getProtocolAndParametersAsString() Returns the raw specification of the protocol name and parameters.
public HashMap<String, String>	Returns: a HashMap with key/value pairs for protocol parameters. getProtocolParameters() Returns the protocol parameters as a Hashmap with key/value pairs.
public String	Returns: The uninterpreted protocol parameters as string. getProtocolParametersAsString() Returns the raw specification of the protocol parameters.
public String	Returns: The object name as String. getRootOid() Return the object name.
private static boolean	isAlphaNumeric(String s)
private static boolean	isValidString(String identifier, String validCharSet)
public static UnoUrl	Returns: Object representation of class UnoUrl. parseUnoUrl(String The given uno URl as string. unoUrl) Parses the given Uno Url and returns an in memory object representation.
private static UnoUrl.UnoUrlPart	parseUnoUrlPart(String thePart)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

connection	back to summary
private final UnoUrl.UnoUrlPart connection

FORMAT_ERROR	back to summary
private static final String FORMAT_ERROR

OID_CHAR_SET	back to summary
private static final String OID_CHAR_SET

protocol	back to summary
private final UnoUrl.UnoUrlPart protocol

rootOid	back to summary
private final String rootOid

VALUE_CHAR_SET	back to summary
private static final String VALUE_CHAR_SET

Constructor Detail

UnoUrl	back to summary
private UnoUrl(UnoUrl.UnoUrlPart connectionPart, UnoUrl.UnoUrlPart protocolPart, String rootOid)

Method Detail

buildParamHashMap	back to summary
private static HashMap<String, String> buildParamHashMap(String paramString) throws com.sun.star.lang.IllegalArgumentException

decodeUTF8	back to summary
private static String decodeUTF8(String s) throws com.sun.star.lang.IllegalArgumentException

getConnection	back to summary
public String getConnection() Returns the name of the connection of this Uno Url. Encoded characters are not allowed. Returns:String The connection name as string.

getConnection

back to summary

public String getConnection()

Returns the name of the connection of this Uno Url. Encoded characters are not allowed.

Returns:String: The connection name as string.

getConnectionAndParametersAsString	back to summary
public String getConnectionAndParametersAsString() Returns the raw specification of the connection name and parameters. Encoded characters like '%41' are not decoded. Returns:String The uninterpreted connection name and parameters as string.

getConnectionAndParametersAsString

back to summary

public String getConnectionAndParametersAsString()

Returns the raw specification of the connection name and parameters. Encoded characters like '%41' are not decoded.

Returns:String: The uninterpreted connection name and parameters as string.

getConnectionParameters	back to summary
public HashMap<String, String> getConnectionParameters() Returns the connection parameters as a Hashmap with key/value pairs. Encoded characters like '%41' are decoded. Returns:HashMap<String, String> a HashMap with key/value pairs for connection parameters.

getConnectionParameters

back to summary

public HashMap<String, String> getConnectionParameters()

Returns the connection parameters as a Hashmap with key/value pairs. Encoded characters like '%41' are decoded.

Returns:HashMap<String, String>: a HashMap with key/value pairs for connection parameters.

getConnectionParametersAsString	back to summary
public String getConnectionParametersAsString() Returns the raw specification of the connection parameters. Encoded characters like '%41' are not decoded. Returns:String The uninterpreted connection parameters as string.

getConnectionParametersAsString

back to summary

public String getConnectionParametersAsString()

Returns the raw specification of the connection parameters. Encoded characters like '%41' are not decoded.

Returns:String: The uninterpreted connection parameters as string.

getProtocol	back to summary
public String getProtocol() Returns the name of the protocol of this Uno Url. Encoded characters are not allowed. Returns:String The protocol name as string.

getProtocol

back to summary

public String getProtocol()

Returns the name of the protocol of this Uno Url. Encoded characters are not allowed.

Returns:String: The protocol name as string.

getProtocolAndParametersAsString	back to summary
public String getProtocolAndParametersAsString() Returns the raw specification of the protocol name and parameters. Encoded characters like '%41' are not decoded. Returns:String The uninterpreted protocol name and parameters as string.

getProtocolAndParametersAsString

back to summary

public String getProtocolAndParametersAsString()

Returns the raw specification of the protocol name and parameters. Encoded characters like '%41' are not decoded.

Returns:String: The uninterpreted protocol name and parameters as string.

getProtocolParameters	back to summary
public HashMap<String, String> getProtocolParameters() Returns the protocol parameters as a Hashmap with key/value pairs. Encoded characters like '%41' are decoded. Returns:HashMap<String, String> a HashMap with key/value pairs for protocol parameters.

getProtocolParameters

back to summary

public HashMap<String, String> getProtocolParameters()

Returns the protocol parameters as a Hashmap with key/value pairs. Encoded characters like '%41' are decoded.

Returns:HashMap<String, String>: a HashMap with key/value pairs for protocol parameters.

getProtocolParametersAsString	back to summary
public String getProtocolParametersAsString() Returns the raw specification of the protocol parameters. Encoded characters like '%41' are not decoded. Returns:String The uninterpreted protocol parameters as string.

getProtocolParametersAsString

back to summary

public String getProtocolParametersAsString()

Returns the raw specification of the protocol parameters. Encoded characters like '%41' are not decoded.

Returns:String: The uninterpreted protocol parameters as string.

getRootOid	back to summary
public String getRootOid() Return the object name. Encoded character are not allowed. Returns:String The object name as String.

getRootOid

back to summary

public String getRootOid()

Return the object name. Encoded character are not allowed.

Returns:String: The object name as String.

isAlphaNumeric	back to summary
private static boolean isAlphaNumeric(String s)

isValidString	back to summary
private static boolean isValidString(String identifier, String validCharSet)

parseUnoUrl	back to summary
public static UnoUrl parseUnoUrl(String unoUrl) throws com.sun.star.lang.IllegalArgumentException Parses the given Uno Url and returns an in memory object representation. Parameters unoUrl:String The given uno URl as string. Returns:UnoUrl Object representation of class UnoUrl. Exceptions IllegalArgumentException: if Url cannot be parsed.

parseUnoUrl

back to summary

public static UnoUrl parseUnoUrl(String unoUrl) throws com.sun.star.lang.IllegalArgumentException

Parses the given Uno Url and returns an in memory object representation.

Parameters

unoUrl:String: The given uno URl as string.

Returns:UnoUrl

Object representation of class UnoUrl.

Exceptions

IllegalArgumentException:: if Url cannot be parsed.

parseUnoUrlPart	back to summary
private static UnoUrl.UnoUrlPart parseUnoUrlPart(String thePart) throws com.sun.star.lang.IllegalArgumentException

com.sun.star.lib.uno.helper back to summary

private Class UnoUrl.UnoUrlPart

Class Inheritance

extends Object

java.lang.Object
com.sun.star.lib.uno.helper.UnoUrl.UnoUrlPart

Field Summary

Modifier and Type	Field and Description
private final HashMap<String, String>	partParameters
private final String	partTypeName
private final String	uninterpretedParameterString

Constructor Summary

Access	Constructor and Description
public	UnoUrlPart(String uninterpretedParameterString, String partTypeName, HashMap<String, String> partParameters)

Method Summary

Modifier and Type	Method and Description
public HashMap<String, String>	getPartParameters()
public String	getPartTypeName()
public String	getUninterpretedParameterString()
public String	getUninterpretedString()

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

partParameters	back to summary
private final HashMap<String, String> partParameters

partTypeName	back to summary
private final String partTypeName

uninterpretedParameterString	back to summary
private final String uninterpretedParameterString

Constructor Detail

UnoUrlPart	back to summary
public UnoUrlPart(String uninterpretedParameterString, String partTypeName, HashMap<String, String> partParameters)

Method Detail

getPartParameters	back to summary
public HashMap<String, String> getPartParameters()

getPartTypeName	back to summary
public String getPartTypeName()

getUninterpretedParameterString	back to summary
public String getUninterpretedParameterString()

getUninterpretedString	back to summary
public String getUninterpretedString()

public Class UnoUrl

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class UnoUrl.UnoUrlPart

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail