@ -36,138 +36,266 @@
public class ContactDetail public class ContactDetail
{ {
/ * *
/ * *
* The standard / well - known category of a < tt > ContactDetail < / tt > representing
* Defines all possible categories for a < tt > ContactDetail < / tt > .
* personal details , like name , last name , nickname .
* /
* /
public static final String CATEGORY_PERSONAL = "Personal" ;
public enum Category
{
/ * *
/ * *
* The standard / well - known category of a < tt > ContactDetail < / tt > representing
* The standard / well - known category of a < tt > ContactDetail < / tt >
* organization details , like organization name and job title .
* representing personal details , like name , last name , nickname .
* /
* /
public static final String CATEGORY_ORGANIZATION = "Organisation" ;
Personal ( "Personal" ) ,
/ * *
/ * *
* The standard / well - known category of a < tt > ContactDetail < / tt > representing
* The standard / well - known category of a < tt > ContactDetail < / tt >
* an e - mail address .
* representing organization details , like organization name and job
* /
* title .
public static final String CATEGORY_EMAIL = "Email" ;
* /
Organization ( "Organization" ) ,
/ * *
* The standard / well - known category of a < tt > ContactDetail < / tt > representing
/ * *
* a contact address for instant messaging .
* The standard / well - known category of a < tt > ContactDetail < / tt >
* /
* representing an e - mail address .
public static final String CATEGORY_INSTANT_MESSAGING = "Instant Messaging" ;
* /
Email ( "Email" ) ,
/ * *
* The standard / well - known category of a < tt > ContactDetail < / tt > representing
/ * *
* a phone number .
* The standard / well - known category of a < tt > ContactDetail < / tt >
* /
* representing a contact address for instant messaging .
public static final String CATEGORY_PHONE = "Phone" ;
* /
InstantMessaging ( "InstantMessaging" ) ,
/ * *
* The standard / well - known category of a < tt > ContactDetail < / tt > representing
/ * *
* a postal address .
* The standard / well - known category of a < tt > ContactDetail < / tt >
* /
* representing a phone number .
public static final String CATEGORY_ADDRESS = "Address" ;
* /
Phone ( "Phone" ) ,
/ * *
* The standard / well - known label of a < tt > ContactDetail < / tt > representing a
/ * *
* name . It could be an organization name or a personal name .
* The standard / well - known category of a < tt > ContactDetail < / tt >
* /
* representing a postal address .
public static final String LABEL_NAME = "Name" ;
* /
Address ( "Address" ) ;
/ * *
* The standard / well - known label of a < tt > ContactDetail < / tt > representing a
/ * *
* last name .
* Current enum value .
* /
* /
public static final String LABEL_LAST_NAME = "Last name" ;
private final String value ;
/ * *
/ * *
* The standard / well - known label of a < tt > ContactDetail < / tt > representing a
* Creates enum whith the specified value .
* nickname .
*
* /
* @param value the value to set .
public static final String LABEL_NICK_NAME = "Nickname" ;
* /
Category ( String value )
/ * *
{
* The standard / well - known label of a < tt > ContactDetail < / tt > representing an
this . value = value ;
* address of a contact at their home .
}
* /
public static final String LABEL_HOME = "Home" ;
/ * *
* The standard / well - known label of a < tt > ContactDetail < / tt > representing a
* mobile contact address ( e . g . a cell phone number ) .
* /
public static final String LABEL_MOBILE = "Mobile" ;
/ * *
* The standard / well - known label of a < tt > ContactDetail < / tt > representing an
* address of a contact at their work .
* /
public static final String LABEL_WORK = "Work" ;
/ * *
* The standard / well - known label of a < tt > ContactDetail < / tt > representing a
* fax number .
* /
public static final String LABEL_FAX = "Fax" ;
/ * *
* The standard / well - known label of a < tt > ContactDetail < / tt > representing a
* different number .
* /
public static final String LABEL_OTHER = "Other" ;
/ * *
/ * *
* The standard / well - known label of a < tt > ContactDetail < / tt > representing a
* Gets the value .
* country name .
*
* /
* @return the value
public static final String LABEL_COUNTRY = "Country" ;
* /
public String value ( )
{
return value ;
}
/ * *
/ * *
* The standard / well - known label of a < tt > ContactDetail < / tt > representing a
* Creates enum from its value .
* city name .
*
* /
* @param value the enum ' s value .
public static final String LABEL_CITY = "City" ;
* @return created enum .
* /
public static Category fromString ( String value )
{
if ( value ! = null )
{
for ( Category category : Category . values ( ) )
{
if ( value . equalsIgnoreCase ( category . value ( ) ) )
{
return category ;
}
}
return null ;
}
return null ;
}
}
/ * *
/ * *
* The standard / well - known label of a < tt > ContactDetail < / tt > representing a
* Defines all possible sub - categories for a < tt > ContactDetail < / tt > .
* street address .
* /
* /
public static final String LABEL_STREET = "Street" ;
public enum SubCategory
{
/ * *
* The standard / well - known label of a < tt > ContactDetail < / tt >
* representing a name . It could be an organization name or a personal
* name .
* /
Name ( "Name" ) ,
/ * *
* The standard / well - known label of a < tt > ContactDetail < / tt >
* representing a last name .
* /
LastName ( "LastName" ) ,
/ * *
* The standard / well - known label of a < tt > ContactDetail < / tt >
* representing a nickname .
* /
Nickname ( "Nickname" ) ,
/ * *
* The standard / well - known label of a < tt > ContactDetail < / tt >
* representing a postal code .
* /
HomePage ( "HomePage" ) ,
/ * *
* The standard / well - known label of a < tt > ContactDetail < / tt >
* representing an address of a contact at their home .
* /
Home ( "Home" ) ,
/ * *
* The standard / well - known label of a < tt > ContactDetail < / tt >
* representing a mobile contact address ( e . g . a cell phone number ) .
* /
Mobile ( "Mobile" ) ,
/ * *
* The standard / well - known label of a < tt > ContactDetail < / tt >
* representing an address of a contact at their work .
* /
Work ( "Work" ) ,
/ * *
* The standard / well - known label of a < tt > ContactDetail < / tt >
* representing a fax number .
* /
Fax ( "Fax" ) ,
/ * *
* The standard / well - known label of a < tt > ContactDetail < / tt >
* representing a different number .
* /
Other ( "Other" ) ,
/ * *
* The standard / well - known label of a < tt > ContactDetail < / tt >
* representing an IM network ( like for example jabber ) .
* /
AIM ( "AIM" ) ,
ICQ ( "ICQ" ) ,
MSN ( "MSN" ) ,
Jabber ( "Jabber" ) ,
Skype ( "Skype" ) ,
Yahoo ( "Yahoo" ) ,
Facebook ( "Facebook" ) ,
GoogleTalk ( "GoogleTalk" ) ,
/ * *
* The standard / well - known label of a < tt > ContactDetail < / tt >
* representing a country name .
* /
Country ( "Country" ) ,
/ * *
* The standard / well - known label of a < tt > ContactDetail < / tt >
* representing a city name .
* /
City ( "City" ) ,
/ * *
* The standard / well - known label of a < tt > ContactDetail < / tt >
* representing a street address .
* /
Street ( "Street" ) ,
/ * *
* The standard / well - known label of a < tt > ContactDetail < / tt >
* representing a postal code .
* /
PostalCode ( "PostalCode" ) ,
/ * *
* The standard / well - known label of a < tt > ContactDetail < / tt >
* representing a job title .
* /
JobTitle ( "JobTitle" ) ;
/ * *
* Current enum value .
* /
private final String value ;
/ * *
* Creates enum whith the specified value .
*
* @param value the value to set .
* /
SubCategory ( String value )
{
this . value = value ;
}
/ * *
/ * *
* The standard / well - known label of a < tt > ContactDetail < / tt > representing a
* Gets the value .
* postal code .
*
* /
* @return the value
public static final String LABEL_POSTAL_CODE = "Postal code" ;
* /
public String value ( )
{
return value ;
}
/ * *
/ * *
* The standard / well - known label of a < tt > ContactDetail < / tt > representing a
* Creates enum from its value .
* job title .
*
* /
* @param value the enum ' s value .
public static final String LABEL_JOB_TITLE = "Job title" ;
* @return created enum .
* /
public static SubCategory fromString ( String value )
{
if ( value ! = null )
{
for ( SubCategory subCategory : SubCategory . values ( ) )
{
if ( value . equalsIgnoreCase ( subCategory . value ( ) ) )
{
return subCategory ;
}
}
return null ;
}
return null ;
}
}
/ * *
/ * *
* The category of this < tt > ContactQuery < / tt > . For example ,
* The category of this < tt > ContactQuery < / tt > . For example ,
* { @link # CATEGORY_PHONE } or { @link # CATEGORY_EMAIL } .
* { @link # CATEGORY_PHONE } or { @link # CATEGORY_EMAIL } .
* /
* /
private final String category ;
private final Category category ;
/ * *
/ * *
* The address of this contact detail . This should be the address through
* The address of this contact detail . This should be the address through
* which the contact could be reached by one of the supported
* which the contact could be reached by one of the supported
* < tt > OperationSet < / tt > s ( e . g . by IM , call ) .
* < tt > OperationSet < / tt > s ( e . g . by IM , call ) .
* /
* /
private final String contactAddress ;
pr otected String contactDetailValue ;
/ * *
/ * *
* The set of labels of this < tt > ContactDetail < / tt > . The labels may be
* The set of labels of this < tt > ContactDetail < / tt > . The labels may be
* arbitrary and may include any of the standard / well - known labels defined
* arbitrary and may include any of the standard / well - known labels defined
* by the < tt > LABEL_XXX < / tt > constants of the < tt > ContactDetail < / tt > class .
* by the < tt > LABEL_XXX < / tt > constants of the < tt > ContactDetail < / tt > class .
* /
* /
private final Collection < String > labels = new LinkedList < String > ( ) ;
private final Collection < SubCategory > subCategories
= new LinkedList < SubCategory > ( ) ;
/ * *
/ * *
* A mapping of < tt > OperationSet < / tt > classes and preferred protocol
* A mapping of < tt > OperationSet < / tt > classes and preferred protocol
@ -190,11 +318,12 @@ public class ContactDetail
/ * *
/ * *
* Creates a < tt > ContactDetail < / tt > by specifying the contact address ,
* Creates a < tt > ContactDetail < / tt > by specifying the contact address ,
* corresponding to this detail .
* corresponding to this detail .
* @param contactAddress the contact address corresponding to this detail
* @param contactDetailValue the contact detail value corresponding to this
* detail
* /
* /
public ContactDetail ( String contact Address )
public ContactDetail ( String contact DetailValue )
{
{
this ( contact Address , null ) ;
this ( contact DetailValue, null , null ) ;
}
}
/ * *
/ * *
@ -202,83 +331,33 @@ public ContactDetail(String contactAddress)
* specific contact address and which is to be optionally labeled with a
* specific contact address and which is to be optionally labeled with a
* specific set of labels .
* specific set of labels .
*
*
* @param contactAddress the contact address to be represented by the new
* @param contactDetailValue the contact detail value to be represented by
* < tt > ContactDetail < / tt > instance
* the new < tt > ContactDetail < / tt > instance
* @param labels the set of labels with which the new < tt > ContactDetail < / tt >
* @param category
* instance is to be labeled . The labels may be arbitrary and may include
* @param subCategories the set of sub categories with which the new
* any of the standard / well - known labels defined by the < tt > LABEL_XXX < / tt >
* < tt > ContactDetail < / tt > instance is to be labeled .
* constants of the < tt > ContactDetail < / tt > class . For the sake of
* /
* convenience , < tt > null < / tt > and duplicate values in the specified
public ContactDetail ( String contactDetailValue ,
* < tt > String [ ] < / tt > < tt > labels < / tt > will be ignored i . e . will not appear in
Category category ,
* the set of labels reported by the new < tt > ContactDetail < / tt > instance
SubCategory [ ] subCategories )
* later on . Additionally , the < tt > category < / tt > of the new
* < tt > ContactDetail < / tt > instance will be implied from the specified
* < tt > labels < / tt > by looking for the standard / well - known categories defined
* by the < tt > CATEGORY_XXX < / tt > constants of the < tt > ContactDetail < / tt >
* class
* /
public ContactDetail ( String contactAddress , String [ ] labels )
{
{
// contactAddress
// the value of the detail
this . contact Address = contactAddress ;
this . contactDetailValue = contactDetailValue ;
// category & labels
// category & labels
String category = null ;
this . category = category ;
if ( label s ! = null )
if ( subCategorie s ! = null )
{
{
for ( S tring label : label s)
for ( S ubCategory subCategory : subCategorie s)
{
{
if ( ( label ! = null ) & & ! this . labels . contains ( label ) )
if ( ( subCategory ! = null )
& & ! this . subCategories . contains ( subCategory ) )
{
{
if ( label . equals ( CATEGORY_EMAIL )
this . subCategories . add ( subCategory ) ;
| | label . equals ( CATEGORY_INSTANT_MESSAGING )
| | label . equals ( CATEGORY_PHONE ) )
category = label ;
else
this . labels . add ( label ) ;
}
}
}
}
}
}
this . category = category ;
}
/ * *
* Initializes a new < tt > ContactDetail < / tt > instance which is to represent a
* specific contact address and which is to be optionally labeled with a
* specific category and a specific set of labels .
*
* @param contactAddress the contact address to be represented by the new
* < tt > ContactDetail < / tt > instance
* @param category the category ( such as one of the < tt > CATEGORY_XXX < / tt >
* constants defined by the < tt > ContactDetail < / tt > class , for example ) to be
* assigned to the new < tt > ContactDetail < / tt > instance
* @param labels the set of labels with which the new < tt > ContactDetail < / tt >
* instance is to be labeled . The labels may be arbitrary and may include
* any of the standard / well - known labels defined by the < tt > LABEL_XXX < / tt >
* constants of the < tt > ContactDetail < / tt > class . For the sake of
* convenience , < tt > null < / tt > and duplicate values in the specified
* < tt > String [ ] < / tt > < tt > labels < / tt > will be ignored i . e . will not appear in
* the set of labels reported by the new < tt > ContactDetail < / tt > instance
* later on .
* /
public ContactDetail (
String contactAddress ,
String category , String [ ] labels )
{
// contactAddress
this . contactAddress = contactAddress ;
// category
this . category = category ;
// labels
if ( labels ! = null )
{
for ( String label : labels )
{
if ( ( label ! = null ) & & ! this . labels . contains ( label ) )
this . labels . add ( label ) ;
}
}
}
}
/ * *
/ * *
@ -336,23 +415,25 @@ public void setSupportedOpSets(
* @return the category of this < tt > ContactQuery < / tt > if it has any ;
* @return the category of this < tt > ContactQuery < / tt > if it has any ;
* otherwise , < tt > null < / tt >
* otherwise , < tt > null < / tt >
* /
* /
public String getCategory ( )
public Category getCategory ( )
{
{
return category ;
return category ;
}
}
/ * *
/ * *
* Returns the contact address corresponding to this detail .
* Returns the contact address corresponding to this detail .
*
* @return the contact address corresponding to this detail
* @return the contact address corresponding to this detail
* /
* /
public String get ContactAddress ( )
public String get Detail ( )
{
{
return contact Address ;
return contact DetailValue ;
}
}
/ * *
/ * *
* Returns the preferred < tt > ProtocolProviderService < / tt > when using the
* Returns the preferred < tt > ProtocolProviderService < / tt > when using the
* given < tt > opSetClass < / tt > .
* given < tt > opSetClass < / tt > .
*
* @param opSetClass the < tt > OperationSet < / tt > class corresponding to a
* @param opSetClass the < tt > OperationSet < / tt > class corresponding to a
* certain action ( e . g . sending an instant message , making a call , etc . ) .
* certain action ( e . g . sending an instant message , making a call , etc . ) .
* @return the preferred < tt > ProtocolProviderService < / tt > corresponding to
* @return the preferred < tt > ProtocolProviderService < / tt > corresponding to
@ -412,9 +493,9 @@ public List<Class<? extends OperationSet>> getSupportedOperationSets()
* @return < tt > true < / tt > if the specified < tt > label < / tt > is contained in the
* @return < tt > true < / tt > if the specified < tt > label < / tt > is contained in the
* set of labels of this < tt > ContactDetail < / tt >
* set of labels of this < tt > ContactDetail < / tt >
* /
* /
public boolean contains Label( String label )
public boolean contains SubCategory( SubCategory label )
{
{
return label s. contains ( label ) ;
return subCategorie s. contains ( label ) ;
}
}
/ * *
/ * *
@ -426,8 +507,8 @@ public boolean containsLabel(String label)
* < tt > ContactDetail < / tt > has no labels , the returned < tt > Collection < / tt > is
* < tt > ContactDetail < / tt > has no labels , the returned < tt > Collection < / tt > is
* empty .
* empty .
* /
* /
public Collection < S tring> getLabel s( )
public Collection < S ubCategory> getSubCategorie s( )
{
{
return Collections . unmodifiableCollection ( label s) ;
return Collections . unmodifiableCollection ( subCategorie s) ;
}
}
} }
Yana Stamcheva
13 years ago