org.dlese.dpc.schemedit

Class SchemEditUtils

java.lang.Object

org.dlese.dpc.schemedit.SchemEditUtils

public class SchemEditUtils
extends java.lang.Object

Utility methods for SchemEdit

Author:

ostwald

Field Summary

Fields

Modifier and Type	Field and Description
static java.text.SimpleDateFormat	fullDateFormat * Formats and parses dates according to fullDateFormatString.
static java.lang.String	fullDateFormatString same as utcDateFormatString
static java.text.SimpleDateFormat	simpleDateFormat Formats and parses dates according to simpleDateFormatString.
static java.lang.String	simpleDateFormatString "yyyy-MM-dd"
static java.text.SimpleDateFormat	utcDateFormat Formats and parses dates according to utcDateFormatString.
static java.lang.String	utcDateFormatString "yyyy-MM-dd'T'HH:mm:ss'Z'"

Constructor Summary

Constructors

Constructor and Description
SchemEditUtils()

Method Summary

Modifier and Type	Method and Description
static void	box(java.lang.String s) Description of the Method
static java.lang.String	contractAmpersands(java.lang.String in) Contract expanded ampersands (&) that are part of entity references.
static java.lang.String	escapeUriSpaces(java.lang.String uriStr) Escape spaces in the given uriStr so that it may be accepted by URI constructor.
static java.lang.String	expandAmpersands(java.lang.String in) Expand expanded ampersands that are part of entities.
static java.lang.String	formatQuery(java.lang.String q) Encodes query strings beginning with "id:" or "url:" using SimpleLuceneIndex.encodeToTerm(java.lang.String).
static org.apache.struts.action.ActionForward	forwardToCaller(javax.servlet.http.HttpServletRequest request, java.lang.String editedRecId, SessionBean sessionBean) General method to forward control to the appropriate page (Collections, Search or View) after completing an operation.
static java.lang.String	fullDateString(java.util.Date date) Converts a Date object into a string formatted with fullDateFormat
static java.lang.Object	getAttr(java.lang.Object obj, java.lang.String attr) Based on attribute name, attempts to get the value of that attribute using a bean-style "gettter".
static java.lang.String	getCollectionFromIndex(java.lang.String id, SimpleLuceneIndex index) DEPRECIATED - use getCollectionOfIndexedRecord Returns the collection associated with an indexed record.
static java.lang.String	getCollectionOfIndexedRecord(java.lang.String id, RepositoryManager rm) Returns the collection associated with an indexed record.
static DcsSetInfo	getDcsSetInfo(java.lang.String collection, java.util.List dcsSetInfos) pick a given DcsSetInfo from a list
static DcsSetInfo	getDcsSetInfo(java.lang.String collection, RepositoryManager rm) Gets the dcsSetInfo attribute of the SchemEditUtils class
static org.dom4j.Document	getEditableDocument(java.lang.String docUri, MetaDataFramework framework) Returns the localized dom4j.Document from the given uri after checking that the schemaLocation declared by the document at uri corresponds with the schemaLocation known to the MetaDataFramework parameter.
static java.lang.String	getEditableXml(java.io.File file) Gets the editableXml attribute of the SchemEditUtils class
static java.lang.String	getElapsedTimeSimple(long clicks) Return a string representation of the elapsed time since an event date (which is represented as "clicks" since "the epoch").
static java.io.File	getFileFromIndex(java.lang.String id, RepositoryManager rm) Returns the file associated with an id in an index.
static org.dom4j.Document	getLocalizedXmlDocument(java.net.URI uri) Returns a localized xmlDocument for the given uri.
static java.util.List	getMirrorUrls(java.lang.String recordXml) Extracts mirrorUrl values from an adn record
static SetInfo	getSetInfo(java.lang.String collection, RepositoryManager rm) Gets the setInfo attribute of the SchemEditUtils class
static java.lang.String	getUniqueId() Gets the uniqueId attribute of the SchemEditUtils class
static java.lang.Object	getUriRef(java.lang.String uriStr) Gets the uriRef attribute of the SchemEditUtils class
static java.lang.Object	getUriRef(java.lang.String uriStr, java.lang.String docRoot) Gets the uriRef attribute of the SchemEditUtils class
static java.lang.Object	getUriRef(java.net.URI uri) Gets the uriRef attribute of the SchemEditUtils class
static java.lang.Object	getUriRef(java.net.URI uri, java.lang.String docRoot) Given a string representation of a uri, returns either a File or URL instance.
static java.util.Date	getUtcTime() Gets the utcTime attribute of the SchemEditUtils class
static java.util.Date	getUtcTime(java.util.Date date) Gets the utcTime attribute of the SchemEditUtils class
static boolean	hasBadChar(java.lang.String s) Checks given string for characters outside the range of ASCII values
static void	main(java.lang.String[] args) The main program for the SchemEditUtils class
static void	prtln(java.lang.String s) Print a line to standard out.
static void	prtln(java.lang.String s, java.lang.String prefix) Description of the Method
static java.lang.String	quoteWrap(java.lang.String s) Return the given string wrapped in quotation marks
static void	showReferer(javax.servlet.http.HttpServletRequest request) Displays request params for debugging.
static void	showRequestHeaders(javax.servlet.http.HttpServletRequest request) Display request headers for debugging.
static void	showRequestParameters(javax.servlet.http.HttpServletRequest request) Displays request params for debugging.
static void	showRequestParameters(javax.servlet.http.HttpServletRequest request, java.lang.String[] paramFilter) Description of the Method
static void	showRoleInfo(User sessionUser, org.apache.struts.action.ActionMapping mapping) Description of the Method
static java.lang.String	simpleDateString(java.util.Date date) Converts a Date object into a string formatted with simpleDateFormat
static java.lang.String	stuffId(java.lang.String recordXml, java.lang.String id, MetaDataFramework framework) Insert a new id into an existing metadata record
static java.lang.String	toWinPath(java.lang.String path) Replace forward slashes in provided path with backward slashes
static java.lang.String	utcDateString(java.util.Date date) formats the given date in the form "yyyy-MM-dd'T'HH:mm:ss'Z'".

Methods inherited from class java.lang.Object

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

Field Detail

utcDateFormatString

public static java.lang.String utcDateFormatString

"yyyy-MM-dd'T'HH:mm:ss'Z'"

utcDateFormat

public static java.text.SimpleDateFormat utcDateFormat

Formats and parses dates according to utcDateFormatString.

fullDateFormatString

public static java.lang.String fullDateFormatString

same as utcDateFormatString

fullDateFormat

public static java.text.SimpleDateFormat fullDateFormat

* Formats and parses dates according to fullDateFormatString.

simpleDateFormatString

public static java.lang.String simpleDateFormatString

"yyyy-MM-dd"

simpleDateFormat

public static java.text.SimpleDateFormat simpleDateFormat

Formats and parses dates according to simpleDateFormatString.

Constructor Detail

SchemEditUtils

public SchemEditUtils()

Method Detail

forwardToCaller

public static org.apache.struts.action.ActionForward forwardToCaller(javax.servlet.http.HttpServletRequest request,
                                                                     java.lang.String editedRecId,
                                                                     SessionBean sessionBean)

General method to forward control to the appropriate page (Collections, Search or View) after completing an operation. The editedRecId parameter is supplied by metadata editor. It is used to highlight a record in the search view. It may be different from SessionBean.getId(), which is set by the viewing tool.

Parameters:

request - the request object

editedRecId - id of record edited in metadata editor (if any)

sessionBean - a sessionBean instance

Returns:

ActionForward directing to the caller of last operation.

contractAmpersands

public static java.lang.String contractAmpersands(java.lang.String in)

Contract expanded ampersands (&) that are part of entity references. For example, "©" and "©" both become "©". "&" by itself is not contracted. Used to convert xml record into a form desireable for xml files

Parameters:

in - String to be processed

Returns:

processed string

escapeUriSpaces

public static java.lang.String escapeUriSpaces(java.lang.String uriStr)

Escape spaces in the given uriStr so that it may be accepted by URI constructor.

Parameters:

uriStr - Description of the Parameter

Returns:

Description of the Return Value

expandAmpersands

public static java.lang.String expandAmpersands(java.lang.String in)

Expand expanded ampersands that are part of entities. For example, "©" becomes "&#169". Used to convert xml text from file form into a from preferred by dom4j.

Parameters:

in - Description of the Parameter

Returns:

Description of the Return Value

getLocalizedXmlDocument

public static org.dom4j.Document getLocalizedXmlDocument(java.net.URI uri)
                                                  throws java.lang.Exception

Returns a localized xmlDocument for the given uri. NOTE: URI's must have a scheme of either "file" or "http".

NOTEs:

• this method should use getUriRef to resolve the uri into either a file or url.
• what is the difference between this and getEditableXml()?

Parameters:

uri - uri pointing to a file containing xml

Returns:

A localized Document

Throws:

java.lang.Exception - If scheme is not recognized or if a Document could not be created

getUriRef

public static java.lang.Object getUriRef(java.lang.String uriStr)
                                  throws java.lang.Exception,
                                         java.net.URISyntaxException

Gets the uriRef attribute of the SchemEditUtils class

Parameters:

uriStr - Description of the Parameter

Returns:

The uriRef value

Throws:

java.lang.Exception - Description of the Exception

java.net.URISyntaxException - Description of the Exception

getUriRef

public static java.lang.Object getUriRef(java.net.URI uri)
                                  throws java.lang.Exception

Gets the uriRef attribute of the SchemEditUtils class

Parameters:

uri - Description of the Parameter

Returns:

The uriRef value

Throws:

java.lang.Exception - Description of the Exception

getUriRef

public static java.lang.Object getUriRef(java.lang.String uriStr,
                                         java.lang.String docRoot)
                                  throws java.lang.Exception,
                                         java.net.URISyntaxException

Gets the uriRef attribute of the SchemEditUtils class

Parameters:

uriStr - Description of the Parameter

docRoot - Description of the Parameter

Returns:

The uriRef value

Throws:

java.lang.Exception - Description of the Exception

java.net.URISyntaxException - Description of the Exception

getUriRef

public static java.lang.Object getUriRef(java.net.URI uri,
                                         java.lang.String docRoot)
                                  throws java.lang.Exception

Given a string representation of a uri, returns either a File or URL instance.

Relative paths are assumed to be file paths relative to "docRoot" and expanded accordingly into absolute files.

Parameters:

docRoot - Path to docRoot for this application to aid in resolving relative paths.

uri - Description of the Parameter

Returns:

The uriRef value

Throws:

java.lang.Exception - NOT YET DOCUMENTED

getEditableXml

public static java.lang.String getEditableXml(java.io.File file)
                                       throws java.lang.Exception

Gets the editableXml attribute of the SchemEditUtils class

Parameters:

file - NOT YET DOCUMENTED

Returns:

The editableXml value

Throws:

java.lang.Exception - NOT YET DOCUMENTED

getEditableDocument

public static org.dom4j.Document getEditableDocument(java.lang.String docUri,
                                                     MetaDataFramework framework)
                                              throws org.dom4j.DocumentException

Returns the localized dom4j.Document from the given uri after checking that the schemaLocation declared by the document at uri corresponds with the schemaLocation known to the MetaDataFramework parameter.

called from MetaDataFramework.getEditableDocument.

Parameters:

docUri - uri of xml document

framework - MetaDataFramework instance for consistency checking.

Returns:

localized dom4j.Document with ampersands expanded for editing.

Throws:

org.dom4j.DocumentException - Description of the Exception

showReferer

public static void showReferer(javax.servlet.http.HttpServletRequest request)

Displays request params for debugging.

Parameters:

request - Description of the Parameter

showRequestParameters

public static void showRequestParameters(javax.servlet.http.HttpServletRequest request)

Displays request params for debugging.

Filtering out kinds of parameters. Construct an array containing strings which, if found in a parameter name, will filter that param from the display. E.g.,

• metadata editor form values contain params: "("
• metadata editor collapse params contain "_^_"

Parameters:

request - Description of the Parameter

showRequestParameters

public static void showRequestParameters(javax.servlet.http.HttpServletRequest request,
                                         java.lang.String[] paramFilter)

Description of the Method

Parameters:

request - Description of the Parameter

paramFilter - Description of the Parameter

getCollectionFromIndex

public static java.lang.String getCollectionFromIndex(java.lang.String id,
                                                      SimpleLuceneIndex index)

DEPRECIATED - use getCollectionOfIndexedRecord Returns the collection associated with an indexed record.

Parameters:

id - record id

index - a SimpleLuceneIndex instance

Returns:

The collection attribute for the record identified by id

getCollectionOfIndexedRecord

public static java.lang.String getCollectionOfIndexedRecord(java.lang.String id,
                                                            RepositoryManager rm)

Returns the collection associated with an indexed record.

Parameters:

id - record id

rm - Description of the Parameter

Returns:

The collection attribute for the record identified by id

getSetInfo

public static SetInfo getSetInfo(java.lang.String collection,
                                 RepositoryManager rm)

Gets the setInfo attribute of the SchemEditUtils class

Parameters:

collection - Description of the Parameter

rm - Description of the Parameter

Returns:

The setInfo value

getDcsSetInfo

public static DcsSetInfo getDcsSetInfo(java.lang.String collection,
                                       RepositoryManager rm)

Gets the dcsSetInfo attribute of the SchemEditUtils class

Parameters:

collection - Description of the Parameter

rm - Description of the Parameter

Returns:

The dcsSetInfo value

getDcsSetInfo

public static DcsSetInfo getDcsSetInfo(java.lang.String collection,
                                       java.util.List dcsSetInfos)

pick a given DcsSetInfo from a list

Parameters:

collection - Description of the Parameter

dcsSetInfos - Description of the Parameter

Returns:

The dcsSetInfo value

getFileFromIndex

public static java.io.File getFileFromIndex(java.lang.String id,
                                            RepositoryManager rm)

Returns the file associated with an id in an index.

Parameters:

id - record id

rm - Description of the Parameter

Returns:

The source file for the record identified by id

showRoleInfo

public static void showRoleInfo(User sessionUser,
                                org.apache.struts.action.ActionMapping mapping)

Description of the Method

Parameters:

sessionUser - Description of the Parameter

mapping - Description of the Parameter

hasBadChar

public static boolean hasBadChar(java.lang.String s)

Checks given string for characters outside the range of ASCII values

Parameters:

s - String to be checked

Returns:

true if String contains characters with ASCII value above 127.

getUniqueId

public static java.lang.String getUniqueId()

Gets the uniqueId attribute of the SchemEditUtils class

Returns:

The uniqueId value

showRequestHeaders

public static void showRequestHeaders(javax.servlet.http.HttpServletRequest request)

Display request headers for debugging.

Parameters:

request - Description of the Parameter

formatQuery

public static java.lang.String formatQuery(java.lang.String q)

Encodes query strings beginning with "id:" or "url:" using SimpleLuceneIndex.encodeToTerm(java.lang.String).

Parameters:

q - the query string

Returns:

thge formatted query string

quoteWrap

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

Return the given string wrapped in quotation marks

Parameters:

s - the string to quote wrap

Returns:

the quoted string

fullDateString

public static java.lang.String fullDateString(java.util.Date date)

Converts a Date object into a string formatted with fullDateFormat

Parameters:

date - date to be formatted

Returns:

formatted date

simpleDateString

public static java.lang.String simpleDateString(java.util.Date date)

Converts a Date object into a string formatted with simpleDateFormat

Parameters:

date - date to be formatted

Returns:

formatted date

utcDateString

public static java.lang.String utcDateString(java.util.Date date)

formats the given date in the form "yyyy-MM-dd'T'HH:mm:ss'Z'". If given date is null the string return reflects "the epoch", namely January 1, 1970, 00:00:00 GMT.

Parameters:

date - a date object to be formatted

Returns:

the formatted string representation of date

getUtcTime

public static java.util.Date getUtcTime()

Gets the utcTime attribute of the SchemEditUtils class

Returns:

The utcTime value

getUtcTime

public static java.util.Date getUtcTime(java.util.Date date)

Gets the utcTime attribute of the SchemEditUtils class

Parameters:

date - the date object

Returns:

The utcTime value

getElapsedTimeSimple

public static java.lang.String getElapsedTimeSimple(long clicks)

Return a string representation of the elapsed time since an event date (which is represented as "clicks" since "the epoch").

NOTE: this method does not consider elapsed times greater than 24 hours (the elapsed days are simply not shown).

Parameters:

clicks - Description of the Parameter

Returns:

The elapsedTimeSimple value

main

public static void main(java.lang.String[] args)
                 throws java.lang.Exception

The main program for the SchemEditUtils class

Parameters:

args - The command line arguments

Throws:

java.lang.Exception - Description of the Exception

toWinPath

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

Replace forward slashes in provided path with backward slashes

Parameters:

path - the path to convert

Returns:

converted path

getMirrorUrls

public static java.util.List getMirrorUrls(java.lang.String recordXml)

Extracts mirrorUrl values from an adn record

Parameters:

recordXml - xml string to search for mirrorUrls

Returns:

The mirrorUrls value

stuffId

public static java.lang.String stuffId(java.lang.String recordXml,
                                       java.lang.String id,
                                       MetaDataFramework framework)
                                throws java.lang.Exception

Insert a new id into an existing metadata record

Parameters:

recordXml - metadata record as xml string

id - id to insert into the metadata record

framework - MetaDataFramework object for the format of the record

Returns:

Description of the Return Value

Throws:

java.lang.Exception - Description of the Exception

getAttr

public static java.lang.Object getAttr(java.lang.Object obj,
                                       java.lang.String attr)

Based on attribute name, attempts to get the value of that attribute using a bean-style "gettter".

Parameters:

obj - object for which to get attr

attr - attribute to get

Returns:

The attr value

prtln

public static void prtln(java.lang.String s,
                         java.lang.String prefix)

Description of the Method

Parameters:

s - Description of the Parameter

prefix - Description of the Parameter

prtln

public static void prtln(java.lang.String s)

Print a line to standard out.

Parameters:

s - The String to print.

box

public static void box(java.lang.String s)

Description of the Method

Parameters:

s - Description of the Parameter