Global Ids
Summary
This section describes the Primordium implementations of org.osid.id.Id.
GlobalURNId
net.okapia.osid.primordium.id.global.GlobalURNId is an immutable class implementing osid.id.Id.
Serialization
A URN.
Valid Characters
Any valid URL character per RFC 2396.
- a-z
- A-Z
- 0-9
- ( ) + , - . = @ ; $ _ ! * '
Constructors
Constructing BasicId
/**
* Creates a new GlobalURNId using the "urn" namespace.
*
* @param authority the authority for this Id
* @param identifier the identifier for this Id
* @throws org.osid.NullArgumentException null argument provided
*/
public GlobalURLId(String authority, String identifier);
Static Factories
From a String
/**
* Returns an Id from a string representation of a URN.
*
* @param urn the string to be parsed
* @return an Id with the string components
* @throws org.osid.InvalidArgumentException string could not be parsed
* @throws org.osid.NullArgumentException urn is null
*/
public static org.osid.id.Id valueOf(String urn)
GlobalURLId
net.okapia.osid.primordium.id.global.GlobalURLId is an immutable class implementing osid.id.Id.
Serialization
A URL.
Valid Characters
Any valid URL character per RFC 2396.
- a-z
- A-Z
- 0-9
- . - _ ~ ! * ( ) ' / # ? & = :
Constructors
Constructing BasicId
/**
* Creates a new GlobalURLId using the "url" namespace.
*
* @param authority the authority for this Id
* @param identifier the identifier for this Id
* @throws org.osid.NullArgumentException null argument provided
*/
public GlobalURLId(String authority, String identifier);
Static Factories
From a String
/**
* Returns an Id from a string representation of a URL.
*
* @param url the string to be parsed
* @return an Id
* @throws org.osid.InvalidArgumentException string could not be parsed
* @throws org.osid.NullArgumentException str is null
*/
public static org.osid.id.Id valueOf(String url)
From a URL
/**
* Returns an Id from a Java URL.
*
* @param url the url
* @throws org.osid.InvalidArgumentException url could not be parsed
* @throws org.osid.NullArgumentException str is null
*/
public static org.osid.id.Id valueOf(java.net.URL url)
PathId
net.okapia.osid.primordium.id.global.PathId is an immutable class implementing osid.id.Id.
Serialization
A path name.
Constructors
Constructing BasicId
/**
* Creates a new PathId using the "path" namespace and "localhost" authority.
*
* @param path the path
* @throws org.osid.NullArgumentException null argument provided
*/
public PathId(String path);
Static Factories
From a String
/**
* Returns an Id from path name. The path name is converted to its canonical absolute form
* by removing redundant components such as . and ..
*
* @param path the path
* @return an Id
* @throws org.osid.InvalidArgumentException could not get path
* @throws org.osid.NullArgumentException path is null
*/
public static org.osid.id.Id valueOf(String path)
From a URL
/**
* Returns an Id from a Java File. The path name is converted to its canonical absolute form
* by removing redundant components such as . and ..
*
* @param file the file
* @throws org.osid.InvalidArgumentException could not get path
* @throws org.osid.NullArgumentException file is null
*/
public static org.osid.id.Id valueOf(java.io.File file)