org.sakaiproject.citation.impl

Class BaseCitationService.BasicCitation

java.lang.Object

org.sakaiproject.citation.impl.BaseCitationService.BasicCitation

All Implemented Interfaces:

org.sakaiproject.citation.api.Citation

Enclosing class:

BaseCitationService

public class BaseCitationService.BasicCitation
extends Object
implements org.sakaiproject.citation.api.Citation

Field Summary

Fields

Modifier and Type	Field and Description
protected Map	m_citationProperties
protected String	m_citationUrl
protected String	m_fullTextUrl
protected String	m_id
protected String	m_imageUrl
protected boolean	m_isAdded
protected int	m_position
protected String	m_preferredUrl
protected org.sakaiproject.citation.api.Schema	m_schema
protected String	m_searchSourceUrl
protected Integer	m_serialNumber
protected boolean	m_temporary
protected Map	m_urls
protected static String	OPENURL_BOOK_FORMAT
protected static String	OPENURL_CONTEXT_FORMAT
protected static String	OPENURL_JOURNAL_FORMAT
protected static String	OPENURL_VERSION

Fields inherited from interface org.sakaiproject.citation.api.Citation

ADD_PREFIX_TEXT, OMIT_PREFIX_TEXT

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	BaseCitationService.BasicCitation() Constructs a temporary citation.
protected	BaseCitationService.BasicCitation(org.osid.repository.Asset asset) Constructs a temporary citation based on an asset.
	BaseCitationService.BasicCitation(BaseCitationService.BasicCitation other)
	BaseCitationService.BasicCitation(String mediatype) Construct a citation not marked as temporary of a particular type.
	BaseCitationService.BasicCitation(String citationId, org.sakaiproject.citation.api.Schema schema)
	BaseCitationService.BasicCitation(String citationId, String mediatype) Construct a citation not marked as temporary of a particular type with a particular id.

Method Summary

Methods

Modifier and Type	Method and Description
String	addCustomUrl(String label, String url)
String	addCustomUrl(String label, String url, String prefixRequest)
boolean	addPrefixToUrl(String id) Add prefix text to this URL?
void	addPropertyValue(String name, Object value)
void	copy(org.sakaiproject.citation.api.Citation citation)
void	exportRis(StringBuilder buffer)
void	exportRisField(String rislabel, List propvalues, StringBuilder buffer, String prefix)
void	exportRisField(String rislabel, Object val, StringBuilder buffer)
void	exportRisField(String rislabel, Object val, StringBuilder buffer, String prefix)
void	exportRisField(String rislabel, String value, StringBuilder buffer)
void	exportRisField(String rislabel, String value, StringBuilder buffer, String prefix)
String	getAbstract()
Map	getCitationProperties()
Object	getCitationProperty(String name)
Object	getCitationProperty(String name, boolean needSingleValue)
String	getCreator()
String	getCustomUrl(String id) Fetch a custom (direct) URL by ID.
List	getCustomUrlIds()
String	getCustomUrlLabel(String id)
String	getDisplayName()
String	getFirstAuthor()
String	getId()
String	getOpenurl()
String	getOpenurlParameters()
int	getPosition() This only makes sense, and will only be set, in the context of a collection.
String	getPreferredUrlId()
String	getPrimaryUrl() Get the primary URL for this resource Normally, this is an OpenURL created from citation properties, but if either the Repository OSID or the user has designated a preferred URL, we'll use it instead.
org.sakaiproject.citation.api.Schema	getSchema()
String	getSource()
String	getSubjectString()
String	getUnprefixedCustomUrl(String id) Fetch a custom (direct) URL by ID.
String	getUrlPrefix() Fetch the configured URL prefix string.
String	getYear()
boolean	hasCitationProperty(String fieldId)
boolean	hasCustomUrls()
boolean	hasPreferredUrl()
boolean	hasPropertyValue(String fieldId)
void	importFromRis(InputStream ris)
boolean	importFromRisList(List risImportList)
boolean	isAdded()
protected boolean	isCurrentlyMultivalued(String fieldId) Checks if the field is currently multivalued.
boolean	isMultivalued(String fieldId)
protected boolean	isSchemaLimited(String fieldId)
protected boolean	isSchemaMultivalued(String fieldId) Should the field be limited to a single value.
boolean	isTemporary()
List	listCitationProperties()
protected void	matchSchema()
void	setAdded(boolean added)
void	setCitationProperty(String name, Object value)
protected void	setDefaults()
void	setDisplayName(String name)
void	setPosition(int position) This only makes sense, and will only be set, in the context of a collection.
void	setPreferredUrl(String urlid)
void	setSchema(org.sakaiproject.citation.api.Schema schema)
protected void	setType(String mediatype)
String	toString()
void	updateCitationProperty(String name, List values)
void	updateCustomUrl(String urlid, String label, String url, String prefixRequest)

Methods inherited from class java.lang.Object

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

Field Detail

OPENURL_VERSION

protected static final String OPENURL_VERSION

See Also:

Constant Field Values

OPENURL_CONTEXT_FORMAT

protected static final String OPENURL_CONTEXT_FORMAT

See Also:

Constant Field Values

OPENURL_JOURNAL_FORMAT

protected static final String OPENURL_JOURNAL_FORMAT

See Also:

Constant Field Values

OPENURL_BOOK_FORMAT

protected static final String OPENURL_BOOK_FORMAT

See Also:

Constant Field Values

m_citationProperties

protected Map m_citationProperties

m_urls

protected Map m_urls

m_citationUrl

protected String m_citationUrl

m_fullTextUrl

protected String m_fullTextUrl

m_id

protected String m_id

m_imageUrl

protected String m_imageUrl

m_position

protected int m_position

m_schema

protected org.sakaiproject.citation.api.Schema m_schema

m_searchSourceUrl

protected String m_searchSourceUrl

m_serialNumber

protected Integer m_serialNumber

m_temporary

protected boolean m_temporary

m_isAdded

protected boolean m_isAdded

m_preferredUrl

protected String m_preferredUrl

Constructor Detail

BaseCitationService.BasicCitation

protected BaseCitationService.BasicCitation()

Constructs a temporary citation.

BaseCitationService.BasicCitation

protected BaseCitationService.BasicCitation(org.osid.repository.Asset asset)

Constructs a temporary citation based on an asset.

Parameters:

asset -

BaseCitationService.BasicCitation

public BaseCitationService.BasicCitation(BaseCitationService.BasicCitation other)

Parameters:

other -

BaseCitationService.BasicCitation

public BaseCitationService.BasicCitation(String mediatype)

Construct a citation not marked as temporary of a particular type.

Parameters:

mediatype -

BaseCitationService.BasicCitation

public BaseCitationService.BasicCitation(String citationId,
                                 org.sakaiproject.citation.api.Schema schema)

BaseCitationService.BasicCitation

public BaseCitationService.BasicCitation(String citationId,
                                 String mediatype)

Construct a citation not marked as temporary of a particular type with a particular id.

Parameters:

citationId -

mediatype -

Method Detail

matchSchema

protected void matchSchema()

addCustomUrl

public String addCustomUrl(String label,
                  String url)

Specified by:

addCustomUrl in interface org.sakaiproject.citation.api.Citation

addCustomUrl

public String addCustomUrl(String label,
                  String url,
                  String prefixRequest)

Specified by:

addCustomUrl in interface org.sakaiproject.citation.api.Citation

updateCustomUrl

public void updateCustomUrl(String urlid,
                   String label,
                   String url,
                   String prefixRequest)

Specified by:

updateCustomUrl in interface org.sakaiproject.citation.api.Citation

addPropertyValue

public void addPropertyValue(String name,
                    Object value)

Specified by:

addPropertyValue in interface org.sakaiproject.citation.api.Citation

copy

public void copy(org.sakaiproject.citation.api.Citation citation)

Parameters:

citation -

exportRisField

public void exportRisField(String rislabel,
                  String value,
                  StringBuilder buffer,
                  String prefix)

exportRisField

public void exportRisField(String rislabel,
                  String value,
                  StringBuilder buffer)

exportRisField

public void exportRisField(String rislabel,
                  List propvalues,
                  StringBuilder buffer,
                  String prefix)

exportRisField

public void exportRisField(String rislabel,
                  Object val,
                  StringBuilder buffer,
                  String prefix)

exportRisField

public void exportRisField(String rislabel,
                  Object val,
                  StringBuilder buffer)

exportRis

public void exportRis(StringBuilder buffer)
               throws IOException

Specified by:

exportRis in interface org.sakaiproject.citation.api.Citation

Throws:

IOException

getCitationProperties

public Map getCitationProperties()

Specified by:

getCitationProperties in interface org.sakaiproject.citation.api.Citation

getCitationProperty

public Object getCitationProperty(String name)

Specified by:

getCitationProperty in interface org.sakaiproject.citation.api.Citation

getCitationProperty

public Object getCitationProperty(String name,
                         boolean needSingleValue)

Specified by:

getCitationProperty in interface org.sakaiproject.citation.api.Citation

getCreator

public String getCreator()

Specified by:

getCreator in interface org.sakaiproject.citation.api.Citation

getCustomUrl

public String getCustomUrl(String id)
                    throws org.sakaiproject.exception.IdUnusedException

Fetch a custom (direct) URL by ID.

Specified by:

getCustomUrl in interface org.sakaiproject.citation.api.Citation

Throws:

org.sakaiproject.exception.IdUnusedException

See Also:

Citation.getCustomUrl(java.lang.String)

getUnprefixedCustomUrl

public String getUnprefixedCustomUrl(String id)
                              throws org.sakaiproject.exception.IdUnusedException

Fetch a custom (direct) URL by ID. The URL prefix (if applicable) is not added.

Specified by:

getUnprefixedCustomUrl in interface org.sakaiproject.citation.api.Citation

Throws:

org.sakaiproject.exception.IdUnusedException

See Also:

Citation.getUnprefixedCustomUrl(java.lang.String)

getUrlPrefix

public String getUrlPrefix()

Fetch the configured URL prefix string.

Specified by:

getUrlPrefix in interface org.sakaiproject.citation.api.Citation

Returns:

The prefix (null if none)

See Also:

Citation.getUnprefixedCustomUrl(java.lang.String)

addPrefixToUrl

public boolean addPrefixToUrl(String id)
                       throws org.sakaiproject.exception.IdUnusedException

Add prefix text to this URL?

Specified by:

addPrefixToUrl in interface org.sakaiproject.citation.api.Citation

Returns:

true If the URL should get the prefix

Throws:

org.sakaiproject.exception.IdUnusedException

getCustomUrlIds

public List getCustomUrlIds()

Specified by:

getCustomUrlIds in interface org.sakaiproject.citation.api.Citation

getCustomUrlLabel

public String getCustomUrlLabel(String id)
                         throws org.sakaiproject.exception.IdUnusedException

Specified by:

getCustomUrlLabel in interface org.sakaiproject.citation.api.Citation

Throws:

org.sakaiproject.exception.IdUnusedException

getYear

public String getYear()

Specified by:

getYear in interface org.sakaiproject.citation.api.Citation

getDisplayName

public String getDisplayName()

Specified by:

getDisplayName in interface org.sakaiproject.citation.api.Citation

getPrimaryUrl

public String getPrimaryUrl()

Get the primary URL for this resource Normally, this is an OpenURL created from citation properties, but if either the Repository OSID or the user has designated a preferred URL, we'll use it instead.

Specified by:

getPrimaryUrl in interface org.sakaiproject.citation.api.Citation

Returns:

The primary URL (null if none available)

getFirstAuthor

public String getFirstAuthor()

Specified by:

getFirstAuthor in interface org.sakaiproject.citation.api.Citation

getId

public String getId()

Specified by:

getId in interface org.sakaiproject.citation.api.Citation

getOpenurl

public String getOpenurl()

Specified by:

getOpenurl in interface org.sakaiproject.citation.api.Citation

getOpenurlParameters

public String getOpenurlParameters()

Specified by:

getOpenurlParameters in interface org.sakaiproject.citation.api.Citation

getPosition

public int getPosition()

This only makes sense, and will only be set, in the context of a collection.

Specified by:

getPosition in interface org.sakaiproject.citation.api.Citation

getSchema

public org.sakaiproject.citation.api.Schema getSchema()

Specified by:

getSchema in interface org.sakaiproject.citation.api.Citation

getSource

public String getSource()

Specified by:

getSource in interface org.sakaiproject.citation.api.Citation

getAbstract

public String getAbstract()

getSubjectString

public String getSubjectString()

hasCustomUrls

public boolean hasCustomUrls()

Specified by:

hasCustomUrls in interface org.sakaiproject.citation.api.Citation

hasPropertyValue

public boolean hasPropertyValue(String fieldId)

Specified by:

hasPropertyValue in interface org.sakaiproject.citation.api.Citation

importFromRis

public void importFromRis(InputStream ris)
                   throws IOException

Specified by:

importFromRis in interface org.sakaiproject.citation.api.Citation

Throws:

IOException

importFromRisList

public boolean importFromRisList(List risImportList)

Specified by:

importFromRisList in interface org.sakaiproject.citation.api.Citation

isAdded

public boolean isAdded()

Specified by:

isAdded in interface org.sakaiproject.citation.api.Citation

isMultivalued

public boolean isMultivalued(String fieldId)

Specified by:

isMultivalued in interface org.sakaiproject.citation.api.Citation

isCurrentlyMultivalued

protected boolean isCurrentlyMultivalued(String fieldId)

Checks if the field is currently multivalued. This doesn't consult the schema, but looks what's actually stored.

Parameters:

fieldId - Field name.

Returns:

true if the field is multivalued.

isSchemaMultivalued

protected boolean isSchemaMultivalued(String fieldId)

Should the field be limited to a single value.

Parameters:

fieldId -

Returns:

isTemporary

public boolean isTemporary()

Returns:

isSchemaLimited

protected boolean isSchemaLimited(String fieldId)

listCitationProperties

public List listCitationProperties()

Specified by:

listCitationProperties in interface org.sakaiproject.citation.api.Citation

setAdded

public void setAdded(boolean added)

Specified by:

setAdded in interface org.sakaiproject.citation.api.Citation

setCitationProperty

public void setCitationProperty(String name,
                       Object value)

Specified by:

setCitationProperty in interface org.sakaiproject.citation.api.Citation

hasCitationProperty

public boolean hasCitationProperty(String fieldId)

Specified by:

hasCitationProperty in interface org.sakaiproject.citation.api.Citation

setDefaults

protected void setDefaults()

setDisplayName

public void setDisplayName(String name)

Specified by:

setDisplayName in interface org.sakaiproject.citation.api.Citation

setPosition

public void setPosition(int position)

This only makes sense, and will only be set, in the context of a collection.

Specified by:

setPosition in interface org.sakaiproject.citation.api.Citation

setSchema

public void setSchema(org.sakaiproject.citation.api.Schema schema)

Specified by:

setSchema in interface org.sakaiproject.citation.api.Citation

setType

protected void setType(String mediatype)

toString

public String toString()

Overrides:

toString in class Object

updateCitationProperty

public void updateCitationProperty(String name,
                          List values)

Specified by:

updateCitationProperty in interface org.sakaiproject.citation.api.Citation

getPreferredUrlId

public String getPreferredUrlId()

Specified by:

getPreferredUrlId in interface org.sakaiproject.citation.api.Citation

hasPreferredUrl

public boolean hasPreferredUrl()

Specified by:

hasPreferredUrl in interface org.sakaiproject.citation.api.Citation

setPreferredUrl

public void setPreferredUrl(String urlid)

Specified by:

setPreferredUrl in interface org.sakaiproject.citation.api.Citation