org.sblim.slp
Class ServiceLocationAttribute

java.lang.Object
  extended by org.sblim.slp.ServiceLocationAttribute
All Implemented Interfaces:
java.io.Serializable

public class ServiceLocationAttribute
extends java.lang.Object
implements java.io.Serializable

Service location attribute

See Also:
Serialized Form

Constructor Summary
ServiceLocationAttribute(java.lang.String pString)
          Construct a service location attribute from a String.
ServiceLocationAttribute(java.lang.String pId, java.util.Vector pValues)
          Construct a service location attribute.
 
Method Summary
 boolean equals(java.lang.Object obj)
           
static java.lang.String escapeId(java.lang.String pId)
          Returns an escaped version of the id parameter, suitable for inclusion in a query.
static java.lang.String escapeValue(java.lang.Object pValue)
          Returns a String containing the escaped value parameter as a string, suitable for inclusion in a query.
 java.lang.String getId()
          Returns the attribute's name.
 java.util.Vector getValues()
          Returns a cloned vector of attribute values, or null if the attribute is a keyword attribute.
 int hashCode()
           
static void main(java.lang.String[] args)
           
 java.lang.String serialize()
          Returns the attribute serialized (as comma separated list)
 java.lang.String toString()
           
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Constructor Detail

ServiceLocationAttribute

public ServiceLocationAttribute(java.lang.String pId,
                                java.util.Vector pValues)
Construct a service location attribute. Errors in the id or values vector result in an IllegalArgumentException.

Parameters:
pId - The attribute name. The String can consist of any Unicode character.
pValues - A Vector of one or more attribute values. Vector contents must be uniform in type and one of Integer, String, Boolean, or byte[]. If the attribute is a keyword attribute, then the parameter should be null. String values can consist of any Unicode character.

ServiceLocationAttribute

public ServiceLocationAttribute(java.lang.String pString)
                         throws ServiceLocationException
Construct a service location attribute from a String.

Parameters:
pString - The string to parse
Throws:
ServiceLocationException - When the string parsing failed
Method Detail

escapeId

public static java.lang.String escapeId(java.lang.String pId)
Returns an escaped version of the id parameter, suitable for inclusion in a query. Any reserved characters as specified in [7] are escaped using UTF-8 encoding. If any characters in the tag are illegal, throws IllegalArgumentException.

Parameters:
pId - The attribute id to escape. ServiceLocationException is thrown if any characters are illegal for an attribute tag.
Returns:
The escaped version

escapeValue

public static java.lang.String escapeValue(java.lang.Object pValue)
Returns a String containing the escaped value parameter as a string, suitable for inclusion in a query. If the parameter is a string, any reserved characters as specified in [7] are escaped using UTF-8 encoding. If the parameter is a byte array, then the escaped string begins with the nonUTF-8 sequence `\ff` and the rest of the string consists of the escaped bytes, which is the encoding for opaques. If the value parameter is a Boolean or Integer, then the returned string contains the object converted into a string. If the value is any type other than String, Integer, Boolean or byte[], an IllegalArgumentException is thrown.

Parameters:
pValue - The attribute value to be converted into a string and escaped.
Returns:
The escaped value

getValues

public java.util.Vector getValues()
Returns a cloned vector of attribute values, or null if the attribute is a keyword attribute. If the attribute is single-valued, then the vector contains only one object.

Returns:
The value vector

getId

public java.lang.String getId()
Returns the attribute's name.

Returns:
The name (id)

equals

public boolean equals(java.lang.Object obj)
Overrides:
equals in class java.lang.Object

toString

public java.lang.String toString()
Overrides:
toString in class java.lang.Object

serialize

public java.lang.String serialize()
                           throws ServiceLocationException
Returns the attribute serialized (as comma separated list)

Returns:
The serialized attribute
Throws:
ServiceLocationException

hashCode

public int hashCode()
Overrides:
hashCode in class java.lang.Object

main

public static void main(java.lang.String[] args)


Copyright © 2005, 2007 IBM Corporation. All Rights Reserved.