FileDocCategorySizeDatePackage
RefAddr.javaAPI DocJava SE 5 API4007Fri Aug 26 14:57:40 BST 2005javax.naming

RefAddr

public abstract class RefAddr extends Object implements Serializable
This class represents the address of a communications end-point. It consists of a type that describes the communication mechanism and an address contents determined by an RefAddr subclass.

For example, an address type could be "BSD Printer Address", which specifies that it is an address to be used with the BSD printing protocol. Its contents could be the machine name identifying the location of the printer server that understands this protocol.

A RefAddr is contained within a Reference.

RefAddr is an abstract class. Concrete implementations of it determine its synchronization properties.

author
Rosanna Lee
author
Scott Seligman
version
1.8 03/12/19
see
Reference
see
LinkRef
see
StringRefAddr
see
BinaryRefAddr
since
1.3

Fields Summary
protected String
addrType
Contains the type of this address.
private static final long
serialVersionUID
Use serialVersionUID from JNDI 1.1.1 for interoperability
Constructors Summary
protected RefAddr(String addrType)
Constructs a new instance of RefAddr using its address type.

param
addrType A non-null string describing the type of the address.

	this.addrType = addrType;
    
Methods Summary
public booleanequals(java.lang.Object obj)
Determines whether obj is equal to this RefAddr.

obj is equal to this RefAddr all of these conditions are true

    non-null
  • instance of RefAddr
  • obj has the same address type as this RefAddr (using String.compareTo())
  • both obj and this RefAddr's contents are null or they are equal (using the equals() test).

param
obj possibly null obj to check.
return
true if obj is equal to this refaddr; false otherwise.
see
#getContent
see
#getType

	if ((obj != null) && (obj instanceof RefAddr)) {
	    RefAddr target = (RefAddr)obj;
	    if (addrType.compareTo(target.addrType) == 0) {
		Object thisobj = this.getContent();
		Object thatobj = target.getContent();
		if (thisobj == thatobj)
		    return true;
		if (thisobj != null) 
		    return thisobj.equals(thatobj);
	    }
	}
	return false;
    
public abstract java.lang.ObjectgetContent()
Retrieves the contents of this address.

return
The possibly null address contents.

public java.lang.StringgetType()
Retrieves the address type of this address.

return
The non-null address type of this address.

	return addrType;
    
public inthashCode()
Computes the hash code of this address using its address type and contents. The hash code is the sum of the hash code of the address type and the hash code of the address contents.

return
The hash code of this address as an int.
see
java.lang.Object#hashCode

	return (getContent() == null)
		? addrType.hashCode()
		: addrType.hashCode() + getContent().hashCode();
    
public java.lang.StringtoString()
Generates the string representation of this address. The string consists of the address's type and contents with labels. This representation is intended for display only and not to be parsed.

return
The non-null string representation of this address.

	StringBuffer str = new StringBuffer("Type: " + addrType + "\n");

	str.append("Content: " + getContent() + "\n");
	return (str.toString());