org.restlet.data
Class Protocol

java.lang.Object
  extended by org.restlet.data.Metadata
      extended by org.restlet.data.Protocol

public final class Protocol
extends Metadata

Protocol used by client and server connectors. Connectors enable the communication between components by implementing standard protocols.

Author:
Jerome Louvel

Field Summary
static Protocol AJP
          AJP 1.3 protocol to communicate with Apache HTTP server or Microsoft IIS.
static Protocol ALL
          All protocols wildcard.
static Protocol CLAP
          CLAP (ClassLoader Access Protocol) is a custom scheme to access to representations via classloaders.
static Protocol FILE
          FILE is a standard scheme to access to representations stored in the file system (locally most of the time).
static Protocol FTP
          FTP protocol.
static Protocol HTTP
          HTTP protocol.
static Protocol HTTPS
          HTTPS protocol (via SSL socket).
static Protocol JAR
          JAR (Java ARchive) is a common scheme to access to representations inside archive files.
static Protocol JDBC
          JDBC protocol.
static Protocol POP
          POP protocol.
static Protocol POPS
          POPS protocol (via SSL/TLS socket)..
static Protocol RIAP
          RIAP (Restlet Internal Access Protocol) is a custom scheme to access representations via internal calls to virtual hosts/components.
static Protocol SMTP
          SMTP protocol.
static Protocol SMTP_STARTTLS
          Deprecated. Use the "startTls" parameter on the JavaMail connector instead.
static Protocol SMTPS
          SMTPS protocol (via SSL/TLS socket).
static int UNKNOWN_PORT
          Indicates that the port number is undefined.
static Protocol WAR
          Local Web Archive access protocol.
 
Constructor Summary
Protocol(java.lang.String schemeName)
          Constructor.
Protocol(java.lang.String schemeName, java.lang.String name, java.lang.String description, int defaultPort)
          Constructor.
Protocol(java.lang.String schemeName, java.lang.String name, java.lang.String description, int defaultPort, boolean confidential)
          Constructor.
 
Method Summary
 boolean equals(java.lang.Object object)
          
 int getDefaultPort()
          Returns the default port number.
 java.lang.String getSchemeName()
          Returns the URI scheme name.
 int hashCode()
          
 boolean isConfidential()
          Indicates if the protocol guarantees the confidentially of the messages exchanged, for example via a SSL-secured connection.
static Protocol valueOf(java.lang.String name)
          Creates the protocol associated to a URI scheme name.
 
Methods inherited from class org.restlet.data.Metadata
getDescription, getName, toString
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

UNKNOWN_PORT

public static final int UNKNOWN_PORT
Indicates that the port number is undefined.

See Also:
Constant Field Values

AJP

public static final Protocol AJP
AJP 1.3 protocol to communicate with Apache HTTP server or Microsoft IIS.


ALL

public static final Protocol ALL
All protocols wildcard.


CLAP

public static final Protocol CLAP
CLAP (ClassLoader Access Protocol) is a custom scheme to access to representations via classloaders. Example URI: "clap://thread/org/restlet/Restlet.class".

In order to work, CLAP requires a client connector provided by the core Restlet engine.

See Also:
LocalReference

FILE

public static final Protocol FILE
FILE is a standard scheme to access to representations stored in the file system (locally most of the time). Example URI: "file:///D/root/index.html".

In order to work, FILE requires a client connector provided by the core Restlet engine.

See Also:
LocalReference

FTP

public static final Protocol FTP
FTP protocol.


HTTP

public static final Protocol HTTP
HTTP protocol.


HTTPS

public static final Protocol HTTPS
HTTPS protocol (via SSL socket).


JAR

public static final Protocol JAR
JAR (Java ARchive) is a common scheme to access to representations inside archive files. Example URI: "jar:http://www.foo.com/bar/baz.jar!/COM/foo/Quux.class".

See Also:
LocalReference

JDBC

public static final Protocol JDBC
JDBC protocol.


POP

public static final Protocol POP
POP protocol.


POPS

public static final Protocol POPS
POPS protocol (via SSL/TLS socket)..


RIAP

public static final Protocol RIAP
RIAP (Restlet Internal Access Protocol) is a custom scheme to access representations via internal calls to virtual hosts/components. Example URIs: "riap://component/myAppPath/myResource" and "riap://application/myResource".

In order to work, RIAP doesn't requires any client connector and is automatically supported by the Restlet engine.

See Also:
LocalReference

SMTP

public static final Protocol SMTP
SMTP protocol.


SMTP_STARTTLS

@Deprecated
public static final Protocol SMTP_STARTTLS
Deprecated. Use the "startTls" parameter on the JavaMail connector instead.
SMTP with STARTTLS protocol (started with a plain socket).


SMTPS

public static final Protocol SMTPS
SMTPS protocol (via SSL/TLS socket).


WAR

public static final Protocol WAR
Local Web Archive access protocol.

Constructor Detail

Protocol

public Protocol(java.lang.String schemeName)
Constructor.

Parameters:
schemeName - The scheme name.

Protocol

public Protocol(java.lang.String schemeName,
                java.lang.String name,
                java.lang.String description,
                int defaultPort)
Constructor.

Parameters:
schemeName - The scheme name.
name - The unique name.
description - The description.
defaultPort - The default port.

Protocol

public Protocol(java.lang.String schemeName,
                java.lang.String name,
                java.lang.String description,
                int defaultPort,
                boolean confidential)
Constructor.

Parameters:
schemeName - The scheme name.
name - The unique name.
description - The description.
defaultPort - The default port.
confidential - The confidentiality.
Method Detail

valueOf

public static Protocol valueOf(java.lang.String name)
Creates the protocol associated to a URI scheme name. If an existing constant exists then it is returned, otherwise a new instance is created.

Parameters:
name - The scheme name.
Returns:
The associated protocol.

equals

public boolean equals(java.lang.Object object)

Overrides:
equals in class Metadata

getDefaultPort

public int getDefaultPort()
Returns the default port number.

Returns:
The default port number.

getSchemeName

public java.lang.String getSchemeName()
Returns the URI scheme name.

Returns:
The URI scheme name.

hashCode

public int hashCode()

Overrides:
hashCode in class Metadata

isConfidential

public boolean isConfidential()
Indicates if the protocol guarantees the confidentially of the messages exchanged, for example via a SSL-secured connection.

Returns:
True if the protocol is confidential.


Copyright © 2005-2008 Noelios Technologies.