org.eclipse.emf.cdo.util
Class CDOURIUtil

java.lang.Object
  extended by org.eclipse.emf.cdo.util.CDOURIUtil

public final class CDOURIUtil
extends Object

Various static methods that may help with CDO-specific URIs.

CDO URIs are in one of two different formats, either canonical or connection-aware. The canonical format is:

cdo:// RepositoryUUID / ResourcePath [? Param=Value (& Param=Value)*]
The non-terminals being:

URIs in the canonical form to resolve to resources properly require the resource set to be configured externally so that the connection to the correct repository can be established, for example:
session.openView(resourceSet);
Note that resources preserve their original URI in the scope of the managing view, that is not necessarily in canonical format.

For a description of the connection-aware URI format refer to CDOURIData.

Since:
2.0

Field Summary
static String PROTOCOL_NAME
           
static String SEGMENT_SEPARATOR
           
static char SEGMENT_SEPARATOR_CHAR
           
 
Method Summary
static List<String> analyzePath(String path)
           
static List<String> analyzePath(URI uri)
           
static CDOID convertExternalCDOID(URI baseURI, CDOID newCDOID)
          Converting temporary CDOID to External CDOID
e.g.:
baseURI = cdo://2a57dfcf-8f97-4d39-8e17-9d99ae5c4b3c/resB#5/2
newCDOID = OID2
return = cdo://2a57dfcf-8f97-4d39-8e17-9d99ae5c4b3c/resB#1/2
static URI createResourceURI(CDOSession session, String path)
           
static URI createResourceURI(CDOView view, String path)
           
static URI createResourceURI(String repositoryUUID, String path)
           cdo://repositoryUUID/path The path is added at the end of "cdo://repositoryUUID".
static String extractRepositoryUUID(URI uri)
           
static String[] extractResourceFolderAndName(URI uri)
           
static String extractResourcePath(URI uri)
           
static Map<String,String> getParameters(String query)
           
static void validateURI(URI uri)
          Deprecated.  
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

PROTOCOL_NAME

public static final String PROTOCOL_NAME
Since:
4.0
See Also:
Constant Field Values

SEGMENT_SEPARATOR_CHAR

public static final char SEGMENT_SEPARATOR_CHAR
See Also:
Constant Field Values

SEGMENT_SEPARATOR

public static final String SEGMENT_SEPARATOR
Method Detail

validateURI

@Deprecated
public static void validateURI(URI uri)
                        throws InvalidURIException
Deprecated. 

Throws:
InvalidURIException

extractRepositoryUUID

public static String extractRepositoryUUID(URI uri)

extractResourceFolderAndName

public static String[] extractResourceFolderAndName(URI uri)
                                             throws InvalidURIException
Throws:
InvalidURIException

extractResourcePath

public static String extractResourcePath(URI uri)
                                  throws InvalidURIException
Throws:
InvalidURIException

createResourceURI

public static URI createResourceURI(String repositoryUUID,
                                    String path)

cdo://repositoryUUID/path

The path is added at the end of "cdo://repositoryUUID". If path doesn't start with '/', it will be added automatically.
e.g.: /resA or resA will give the same result -> cdo://repositoryUUID/resA
authority = repositoryUUID
path = /resA


createResourceURI

public static URI createResourceURI(CDOView view,
                                    String path)

createResourceURI

public static URI createResourceURI(CDOSession session,
                                    String path)

convertExternalCDOID

public static CDOID convertExternalCDOID(URI baseURI,
                                         CDOID newCDOID)
Converting temporary CDOID to External CDOID
e.g.:
baseURI = cdo://2a57dfcf-8f97-4d39-8e17-9d99ae5c4b3c/resB#5/2
newCDOID = OID2
return = cdo://2a57dfcf-8f97-4d39-8e17-9d99ae5c4b3c/resB#1/2


analyzePath

public static List<String> analyzePath(URI uri)

analyzePath

public static List<String> analyzePath(String path)

getParameters

public static Map<String,String> getParameters(String query)
Since:
4.0


Copyright (c) 2004 - 2012 Eike Stepper (Berlin, Germany) and others.