public final class Identity extends java.lang.Object implements java.lang.Comparable<Identity>
Represents an identity of an XMPP entity.
This class is immutable.3. Discovering Information About a Jabber Entity
In disco, an entity’s identity is broken down into its category (server, client, gateway, directory, etc.) and its particular type within that category (IM server, phone vs. handheld client, MSN gateway vs. AIM gateway, user directory vs. chatroom directory, etc.). This information helps requesting entities to determine the group or “bucket” of services into which the entity is most appropriately placed (e.g., perhaps the entity is shown in a GUI with an appropriate icon). An entity MAY have multiple identities. When multiple identity elements are provided, the name attributes for each identity element SHOULD have the same value.
Modifier and Type | Method and Description |
---|---|
static Identity |
accountAdmin()
The user@host is an administrative account.
|
static Identity |
accountAnonymous()
The user@host is a “guest” account that allows anonymous login by any user.
|
static Identity |
accountRegistered()
The user@host is a registered or provisioned account associated with a particular non-administrative user.
|
static Identity |
authCert()
A server component that authenticates based on external certificates.
|
static Identity |
authGeneric()
A server authentication component other than one of the registered types.
|
static Identity |
authLdap()
A server component that authenticates against an LDAP database.
|
static Identity |
authNtlm()
A server component that authenticates against an NT domain.
|
static Identity |
authPam()
A server component that authenticates against a PAM system.
|
static Identity |
automationCommandList()
The node for a list of commands; valid only for the node "http://jabber.org/protocol/commands".
|
static Identity |
automationCommandNode()
A node for a specific command; the “node” attribute uniquely identifies the command.
|
static Identity |
automationRpc()
An entity that supports Jabber-RPC.
|
static Identity |
automationSoap()
An entity that supports the SOAP XMPP Binding.
|
static Identity |
automationTranslation()
An entity that provides automated translation services.
|
static Identity |
clientBot()
An automated client that is not controlled by a human user.
|
static Identity |
clientConsole()
Minimal non-GUI client used on dumb terminals or text-only screens.
|
static Identity |
clientGame()
A client running on a gaming console.
|
static Identity |
clientHandheld()
A client running on a PDA, RIM device, or other handheld.
|
static Identity |
clientPc()
Standard full-GUI client used on desktops and laptops.
|
static Identity |
clientPhone()
A client running on a mobile phone or other telephony device.
|
static Identity |
clientSms()
A client that is not actually using an instant messaging client; however, messages sent to this contact will be delivered as Short Message Service (SMS) messages.
|
static Identity |
clientWeb()
A client operated from within a web browser.
|
static Identity |
collaborationWhiteboard()
Multi-user whiteboarding service.
|
int |
compareTo(Identity o)
Implements a natural ordering of an identity, as suggested and required by XEP-0115: Entity Capabilities.
|
static Identity |
componentArchive()
A server component that archives traffic.
|
static Identity |
componentClientToServer()
A server component that handles client connections.
|
static Identity |
componentGeneric()
A server component other than one of the registered types.
|
static Identity |
componentLoadBalancing()
A server component that handles load balancing.
|
static Identity |
componentLog()
A server component that logs server information.
|
static Identity |
componentPresence()
A server component that provides presence information.
|
static Identity |
componentRouter()
A server component that handles core routing logic.
|
static Identity |
componentServerToServer()
A server component that handles server connections .
|
static Identity |
componentSessionManagement()
A server component that manages user sessions.
|
static Identity |
componentStatistics()
A server component that provides server statistics.
|
static Identity |
conferenceIrc()
Internet Relay Chat service.
|
static Identity |
conferenceText()
Text conferencing service.
|
static Identity |
directoryChatRoom()
A directory of chatrooms.
|
static Identity |
directoryGroup()
A directory that provides shared roster groups.
|
static Identity |
directoryUser()
A directory of end users (e.g., JUD).
|
static Identity |
directoryWaitingList()
A directory of waiting list entries.
|
boolean |
equals(java.lang.Object o)
An identity is considered equal, if category, type and language are equal, because there cannot be two identities with the same category, type and language, but with different names.
|
static Identity |
gatewayAIM()
Gateway to AOL Instant Messenger.
|
static Identity |
gatewayFacebook()
Gateway to the Facebook IM service.
|
static Identity |
gatewayGaduGadu()
Gateway to the Gadu-Gadu IM service.
|
static Identity |
gatewayHttpWs()
Gateway that provides HTTP Web Services access.
|
static Identity |
gatewayICQ()
Gateway to ICQ.
|
static Identity |
gatewayIRC()
Gateway to IRC.
|
static Identity |
gatewayLCS()
Gateway to Microsoft Live Communications Server.
|
static Identity |
gatewayMSN()
Gateway to MSN Messenger.
|
static Identity |
gatewayMySpaceIM()
Gateway to the MySpace IM service.
|
static Identity |
gatewayOCS()
Gateway to Microsoft Office Communications Server.
|
static Identity |
gatewayQQ()
Gateway to the QQ IM service.
|
static Identity |
gatewaySametime()
Gateway to IBM Lotus Sametime.
|
static Identity |
gatewaySimple()
Gateway to SIP for Instant Messaging and Presence Leveraging Extensions (SIMPLE).
|
static Identity |
gatewaySkype()
Gateway to the Skype service.
|
static Identity |
gatewaySMS()
Gateway to Short Message Service.
|
static Identity |
gatewaySMTP()
Gateway to the SMTP (email) network.
|
static Identity |
gatewayTlen()
Gateway to the Tlen IM service.
|
static Identity |
gatewayXfire()
Gateway to the Xfire gaming and IM service.
|
static Identity |
gatewayXMPP()
Gateway to another XMPP service (NOT via native server-to-server communication).
|
static Identity |
gatewayYahoo()
Gateway to Yahoo!
|
java.lang.String |
getCategory()
Gets the category, e.g. server, client, gateway, directory, etc.
|
java.util.Locale |
getLanguage()
The optional language to localize the name.
|
java.lang.String |
getName()
Gets the identity’s name.
|
java.lang.String |
getType()
Gets the type within the category, e.g.
|
int |
hashCode() |
static Identity |
headlineNewMail()
Service that notifies a user of new email messages.
|
static Identity |
headlineRss()
RSS notification service.
|
static Identity |
headlineWeather()
Service that provides weather alerts..
|
static Identity |
hierarchyBranch()
A service discovery node that contains further nodes in the hierarchy.
|
static Identity |
hierarchyLeaf()
A service discovery node that does not contain further nodes in the hierarchy.
|
static Identity |
ofCategoryAndType(java.lang.String category,
java.lang.String type)
Creates an identity with a category and type.
|
static Identity |
proxyByteStreams()
SOCKS5 bytestreams proxy service.
|
static Identity |
pubsubCollection()
A pubsub node of the “collection” type.
|
static Identity |
pubsubLeaf()
A pubsub node of the “leaf” type.
|
static Identity |
pubsubPersonalEventingService()
A personal eventing service that supports the publish-subscribe subset defined in XEP-0163..
|
static Identity |
pubsubService()
A pubsub service that supports the functionality defined in XEP-0060.
|
static Identity |
serverInstantMessaging()
Standard Jabber/XMPP server used for instant messaging and presence.
|
static Identity |
storeBerkeley()
A server component that stores data in a Berkeley database.
|
static Identity |
storeFile()
A server component that stores data on the file system.
|
static Identity |
storeGeneric()
A server data storage component other than one of the registered types.
|
static Identity |
storeLdap()
A server component that stores data in an LDAP database.
|
static Identity |
storeMySQL()
A server component that stores data in a MySQL database.
|
static Identity |
storeOracle()
A server component that stores data in an Oracle database.
|
static Identity |
storePostgreSQL()
A server component that stores data in a PostgreSQL database.
|
java.lang.String |
toString() |
Identity |
withName(java.lang.String name)
Creates a new identity with a name.
|
Identity |
withName(java.lang.String name,
java.util.Locale language)
Creates a new identity with a name and a language.
|
public static Identity ofCategoryAndType(java.lang.String category, java.lang.String type)
Creates an identity with a category and type.
Only use this method in exceptional cases, in most case you should use one of the many static factory methods, which creates a registered identity, e.g. clientBot()
category
- The category.type
- The type.public static Identity accountAdmin()
The user@host is an administrative account.
public static Identity accountAnonymous()
The user@host is a “guest” account that allows anonymous login by any user.
public static Identity accountRegistered()
The user@host is a registered or provisioned account associated with a particular non-administrative user.
public static Identity authCert()
A server component that authenticates based on external certificates.
public static Identity authGeneric()
A server authentication component other than one of the registered types.
public static Identity authLdap()
A server component that authenticates against an LDAP database.
public static Identity authNtlm()
A server component that authenticates against an NT domain.
public static Identity authPam()
A server component that authenticates against a PAM system.
public static Identity automationCommandList()
The node for a list of commands; valid only for the node "http://jabber.org/protocol/commands".
public static Identity automationCommandNode()
A node for a specific command; the “node” attribute uniquely identifies the command.
public static Identity automationRpc()
An entity that supports Jabber-RPC.
public static Identity automationSoap()
An entity that supports the SOAP XMPP Binding.
public static Identity automationTranslation()
An entity that provides automated translation services.
public static Identity clientBot()
An automated client that is not controlled by a human user.
public static Identity clientConsole()
Minimal non-GUI client used on dumb terminals or text-only screens.
public static Identity clientGame()
A client running on a gaming console.
public static Identity clientHandheld()
A client running on a PDA, RIM device, or other handheld.
public static Identity clientPc()
Standard full-GUI client used on desktops and laptops.
public static Identity clientPhone()
A client running on a mobile phone or other telephony device.
public static Identity clientSms()
A client that is not actually using an instant messaging client; however, messages sent to this contact will be delivered as Short Message Service (SMS) messages.
public static Identity clientWeb()
A client operated from within a web browser.
public static Identity collaborationWhiteboard()
Multi-user whiteboarding service.
public static Identity componentArchive()
A server component that archives traffic.
public static Identity componentClientToServer()
A server component that handles client connections.
public static Identity componentGeneric()
A server component other than one of the registered types.
public static Identity componentLoadBalancing()
A server component that handles load balancing.
public static Identity componentLog()
A server component that logs server information.
public static Identity componentPresence()
A server component that provides presence information.
public static Identity componentRouter()
A server component that handles core routing logic.
public static Identity componentServerToServer()
A server component that handles server connections .
public static Identity componentSessionManagement()
A server component that manages user sessions.
public static Identity componentStatistics()
A server component that provides server statistics.
public static Identity conferenceIrc()
Internet Relay Chat service.
public static Identity conferenceText()
Text conferencing service.
public static Identity directoryChatRoom()
A directory of chatrooms.
public static Identity directoryGroup()
A directory that provides shared roster groups.
public static Identity directoryUser()
A directory of end users (e.g., JUD).
public static Identity directoryWaitingList()
A directory of waiting list entries.
public static Identity gatewayAIM()
Gateway to AOL Instant Messenger.
public static Identity gatewayFacebook()
Gateway to the Facebook IM service.
public static Identity gatewayGaduGadu()
Gateway to the Gadu-Gadu IM service.
public static Identity gatewayHttpWs()
Gateway that provides HTTP Web Services access.
public static Identity gatewayICQ()
Gateway to ICQ.
public static Identity gatewayIRC()
Gateway to IRC.
public static Identity gatewayLCS()
Gateway to Microsoft Live Communications Server.
public static Identity gatewayMSN()
Gateway to MSN Messenger.
public static Identity gatewayMySpaceIM()
Gateway to the MySpace IM service.
public static Identity gatewayOCS()
Gateway to Microsoft Office Communications Server.
public static Identity gatewayQQ()
Gateway to the QQ IM service.
public static Identity gatewaySametime()
Gateway to IBM Lotus Sametime.
public static Identity gatewaySimple()
Gateway to SIP for Instant Messaging and Presence Leveraging Extensions (SIMPLE).
public static Identity gatewaySkype()
Gateway to the Skype service.
public static Identity gatewaySMS()
Gateway to Short Message Service.
public static Identity gatewaySMTP()
Gateway to the SMTP (email) network.
public static Identity gatewayTlen()
Gateway to the Tlen IM service.
public static Identity gatewayXfire()
Gateway to the Xfire gaming and IM service.
public static Identity gatewayXMPP()
Gateway to another XMPP service (NOT via native server-to-server communication).
public static Identity gatewayYahoo()
Gateway to Yahoo! Instant Messenger.
public static Identity headlineNewMail()
Service that notifies a user of new email messages.
public static Identity headlineRss()
RSS notification service.
public static Identity headlineWeather()
Service that provides weather alerts..
public static Identity hierarchyBranch()
A service discovery node that contains further nodes in the hierarchy.
public static Identity hierarchyLeaf()
A service discovery node that does not contain further nodes in the hierarchy.
public static Identity proxyByteStreams()
SOCKS5 bytestreams proxy service.
public static Identity pubsubCollection()
A pubsub node of the “collection” type.
public static Identity pubsubLeaf()
A pubsub node of the “leaf” type.
public static Identity pubsubPersonalEventingService()
A personal eventing service that supports the publish-subscribe subset defined in XEP-0163..
public static Identity pubsubService()
A pubsub service that supports the functionality defined in XEP-0060.
public static Identity serverInstantMessaging()
Standard Jabber/XMPP server used for instant messaging and presence.
public static Identity storeBerkeley()
A server component that stores data in a Berkeley database.
public static Identity storeFile()
A server component that stores data on the file system.
public static Identity storeGeneric()
A server data storage component other than one of the registered types.
public static Identity storeLdap()
A server component that stores data in an LDAP database.
public static Identity storeMySQL()
A server component that stores data in a MySQL database.
public static Identity storeOracle()
A server component that stores data in an Oracle database.
public static Identity storePostgreSQL()
A server component that stores data in a PostgreSQL database.
public final java.lang.String getCategory()
Gets the category, e.g. server, client, gateway, directory, etc.
public final java.lang.String getType()
Gets the type within the category, e.g. IM server, phone vs. handheld client, MSN gateway vs. AIM gateway, user directory vs. chatroom directory, etc.
public final java.lang.String getName()
Gets the identity’s name.
public final java.util.Locale getLanguage()
The optional language to localize the name.
public final boolean equals(java.lang.Object o)
An identity is considered equal, if category, type and language are equal, because there cannot be two identities with the same category, type and language, but with different names.
equals
in class java.lang.Object
o
- The other object.public final int hashCode()
hashCode
in class java.lang.Object
public final int compareTo(Identity o)
Implements a natural ordering of an identity, as suggested and required by XEP-0115: Entity Capabilities.
compareTo
in interface java.lang.Comparable<Identity>
o
- The other identity.public final java.lang.String toString()
toString
in class java.lang.Object
public Identity withName(java.lang.String name)
Creates a new identity with a name.
name
- The name.public Identity withName(java.lang.String name, java.util.Locale language)
Creates a new identity with a name and a language.
name
- The name.language
- The language.Copyright © 2014–2019 XMPP.rocks. All rights reserved.