dap4.core.util

Class XURI

java.lang.Object

dap4.core.util.XURI

public class XURI
extends java.lang.Object

Provide an extended form of URI parser with the following features: 1. can parse the query and fragment parts. 2. supports multiple protocols 3. supports modification of the URI path. 4. supports url -> string as controlled by flags

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	XURI.Parts

Field Summary

Fields

Modifier and Type	Field and Description
protected static java.util.regex.Pattern	drivelettertest
protected static java.util.regex.Pattern	filedrivelettertest
protected java.util.Map<java.lang.String,java.lang.String>	fragfields
protected boolean	isfile
protected java.util.List<java.lang.String>	nonleadschemes
protected java.util.Map<java.lang.String,java.lang.String>	queryfields
static java.util.EnumSet<XURI.Parts>	URLALL
static java.util.EnumSet<XURI.Parts>	URLONLY
static java.util.EnumSet<XURI.Parts>	URLQUERY

Constructor Summary

Constructors

Constructor and Description
XURI(java.lang.String xu)
XURI(java.net.URI xu)
XURI(java.net.URL xu)

Method Summary

Modifier and Type	Method and Description
static java.lang.String[]	allSchemes(java.lang.String xu) Extract all schemes at front of a url.
java.lang.String	assemble(java.util.EnumSet<XURI.Parts> parts) Reassemble the url using the specified parts
static java.lang.String	canonical(java.lang.String s) Canonicalize a part of a URL
protected java.util.List<java.lang.String>	escapedsplit(java.lang.String s, char sep, char escape)
protected int	findunescaped(java.lang.String s, int start, char sep, char escape, int len)
java.lang.String	fixdriveletter(java.net.URI uri)
java.util.Map<java.lang.String,java.lang.String>	getFragFields()
java.lang.String	getFragment()
java.lang.String	getHost()
java.lang.String	getPath()
int	getPort()
java.lang.String	getQuery()
java.util.Map<java.lang.String,java.lang.String>	getQueryFields()
java.lang.String	getRealPath() Return a path that can be used to open a file
java.lang.String	getScheme()
java.util.List<java.lang.String>	getSchemes()
java.lang.String	getUserInfo()
static boolean	hasDriveLetter(java.lang.String path) return true if this path appears to start with a windows drive letter including those hidden by leading '/'
static java.lang.String	hideDriveLetter(java.lang.String path) Return a path with possible windows drive letter hidden by '/'.
protected java.util.Map<java.lang.String,java.lang.String>	insertAmpField(java.lang.String key, java.lang.String value, java.lang.String query)
void	insertFragmentField(java.lang.String key, java.lang.String newval) Allow fragment fields to be inserted
void	insertQueryField(java.lang.String key, java.lang.String newval) Allow queryfields to be inserted
boolean	isFile()
protected java.util.Map<java.lang.String,java.lang.String>	parseAmpList(java.lang.String s, char sep, char escape)
protected void	parseFragment()
protected void	parseQuery()
protected void	rebuildQuery() Rebuild query from current queryfields
protected java.util.Map<java.lang.String,java.lang.String>	removeAmpField(java.lang.String key, java.lang.String query)
void	removeQueryField(java.lang.String key) Allow queryfields to be removed
void	setFragment(java.lang.String xfragment)
void	setHost(java.lang.String xhost)
void	setPath(java.lang.String xpath)
void	setPort(int xport)
void	setQuery(java.lang.String xquery)
void	setScheme(java.lang.String xscheme)
void	setUserInfo(java.lang.String xuserinfo)
java.lang.String	toString()
static java.lang.String	truePath(java.lang.String path) return repaired path; if this path appears to start with a windows drive letter hidden by leading '/', then the leading '/' is removed

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

drivelettertest

protected static final java.util.regex.Pattern drivelettertest

filedrivelettertest

protected static final java.util.regex.Pattern filedrivelettertest

URLONLY

public static final java.util.EnumSet<XURI.Parts> URLONLY

URLALL

public static final java.util.EnumSet<XURI.Parts> URLALL

URLQUERY

public static final java.util.EnumSet<XURI.Parts> URLQUERY

isfile

protected boolean isfile

nonleadschemes

protected java.util.List<java.lang.String> nonleadschemes

queryfields

protected java.util.Map<java.lang.String,java.lang.String> queryfields

fragfields

protected java.util.Map<java.lang.String,java.lang.String> fragfields

Constructor Detail

XURI

public XURI(java.lang.String xu)
     throws java.net.URISyntaxException

Throws:

java.net.URISyntaxException

XURI

public XURI(java.net.URL xu)
     throws java.net.URISyntaxException

Throws:

java.net.URISyntaxException

XURI

public XURI(java.net.URI xu)
     throws java.net.URISyntaxException

Throws:

java.net.URISyntaxException

Method Detail

getUserInfo

public java.lang.String getUserInfo()

getHost

public java.lang.String getHost()

getPort

public int getPort()

getPath

public java.lang.String getPath()

getRealPath

public java.lang.String getRealPath()

Return a path that can be used to open a file

Returns:

getQuery

public java.lang.String getQuery()

getFragment

public java.lang.String getFragment()

getScheme

public java.lang.String getScheme()

getSchemes

public java.util.List<java.lang.String> getSchemes()

setScheme

public void setScheme(java.lang.String xscheme)

setUserInfo

public void setUserInfo(java.lang.String xuserinfo)

setHost

public void setHost(java.lang.String xhost)

setPort

public void setPort(int xport)

setPath

public void setPath(java.lang.String xpath)

setQuery

public void setQuery(java.lang.String xquery)

setFragment

public void setFragment(java.lang.String xfragment)

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

insertQueryField

public void insertQueryField(java.lang.String key,
                             java.lang.String newval)

Allow queryfields to be inserted

Parameters:

key -

newval -

insertFragmentField

public void insertFragmentField(java.lang.String key,
                                java.lang.String newval)

Allow fragment fields to be inserted

Parameters:

key -

newval -

removeQueryField

public void removeQueryField(java.lang.String key)

Allow queryfields to be removed

Parameters:

key -

rebuildQuery

protected void rebuildQuery()

Rebuild query from current queryfields

isFile

public boolean isFile()

getQueryFields

public java.util.Map<java.lang.String,java.lang.String> getQueryFields()

getFragFields

public java.util.Map<java.lang.String,java.lang.String> getFragFields()

parseQuery

protected void parseQuery()

parseFragment

protected void parseFragment()

insertAmpField

protected java.util.Map<java.lang.String,java.lang.String> insertAmpField(java.lang.String key,
                                                                          java.lang.String value,
                                                                          java.lang.String query)

removeAmpField

protected java.util.Map<java.lang.String,java.lang.String> removeAmpField(java.lang.String key,
                                                                          java.lang.String query)

parseAmpList

protected java.util.Map<java.lang.String,java.lang.String> parseAmpList(java.lang.String s,
                                                                        char sep,
                                                                        char escape)

escapedsplit

protected java.util.List<java.lang.String> escapedsplit(java.lang.String s,
                                                        char sep,
                                                        char escape)

findunescaped

protected int findunescaped(java.lang.String s,
                            int start,
                            char sep,
                            char escape,
                            int len)

assemble

public java.lang.String assemble(java.util.EnumSet<XURI.Parts> parts)

Reassemble the url using the specified parts

Parameters:

parts - to include

Returns:

the assembled uri

fixdriveletter

public java.lang.String fixdriveletter(java.net.URI uri)
                                throws java.net.URISyntaxException

Throws:

java.net.URISyntaxException

canonical

public static java.lang.String canonical(java.lang.String s)

Canonicalize a part of a URL

Parameters:

s - part of the url

hasDriveLetter

public static boolean hasDriveLetter(java.lang.String path)

return true if this path appears to start with a windows drive letter including those hidden by leading '/'

Parameters:

path -

Returns:

true, if path has drive letter

hideDriveLetter

public static java.lang.String hideDriveLetter(java.lang.String path)

Return a path with possible windows drive letter hidden by '/'. Repair => convert "x:/" to "/x:/" where x is a drive letter

Returns:

repaired path

allSchemes

public static java.lang.String[] allSchemes(java.lang.String xu)

Extract all schemes at front of a url.

Returns:

vector of schemes

truePath

public static java.lang.String truePath(java.lang.String path)

return repaired path; if this path appears to start with a windows drive letter hidden by leading '/', then the leading '/' is removed

Parameters:

path -

Returns:

repaired path