Package org.spdx.library.model

Class ExternalDocumentRef

java.lang.Object

org.spdx.library.model.ModelObject

org.spdx.library.model.ExternalDocumentRef

All Implemented Interfaces:

Comparable<ExternalDocumentRef>

public class ExternalDocumentRef
extends ModelObject
implements Comparable<ExternalDocumentRef>

Information about an external SPDX document reference including the checksum. This allows for verification of the external references.

Author:

Gary O'Neall

Field Summary

Fields inherited from class org.spdx.library.model.ModelObject

strict

Constructor Summary

Constructors

Constructor	Description
ExternalDocumentRef()	Default model store, copy manager, and document URI
ExternalDocumentRef(String id)
ExternalDocumentRef(IModelStore modelStore, String documentUri, String id, ModelCopyManager copyManager, boolean create)

Method Summary

Modifier and Type	Method	Description
protected List<String>	_verify(Set<String> verifiedIds, String specVersion)	Implementation of the specific verifications for this model object
int	compareTo(ExternalDocumentRef o)
Optional<Checksum>	getChecksum()
static Optional<ExternalDocumentRef>	getExternalDocRefByDocNamespace(IModelStore stModelStore, String stDocumentUri, String externalDocUri, ModelCopyManager copyManager)	Obtain an ExternalDocumentRef which maps to the document URI for the external SPDX document.
Optional<SpdxDocument>	getSpdxDocument()	Returns the SPDX document if it exists within the same model store, otherwise it returns Optional.empty
String	getSpdxDocumentNamespace()
String	getType()
ExternalDocumentRef	setChecksum(Checksum checksum)
ExternalDocumentRef	setSpdxDocument(SpdxDocument spdxDocument)
ExternalDocumentRef	setSpdxDocumentNamespace(String documentNamespace)	Set the document namespace

Methods inherited from class org.spdx.library.model.ModelObject

addPropertyValueToCollection, addValueToCollection, clearValueCollection, clearValueCollection, clone, copyFrom, createAnnotation, createByteOffsetPointer, createChecksum, createConjunctiveLicenseSet, createCreationInfo, createCrossRef, createDisjunctiveLicenseSet, createExternalDocumentRef, createExternalRef, createExtractedLicense, createLineCharPointer, createPackage, createPackageVerificationCode, createRelationship, createSpdxFile, createSpdxSnippet, createStartEndPointer, enterCriticalSection, equals, equivalent, equivalent, getAnyLicenseInfoPropertyValue, getBooleanPropertyValue, getCopyManager, getDocumentUri, getElementPropertyValue, getEnumPropertyValue, getId, getIntegerPropertyValue, getModelStore, getObjectPropertyValue, getObjectPropertyValue, getObjectPropertyValueCollection, getObjectPropertyValueSet, getPropertyValueNames, getStringCollection, getStringPropertyValue, hashCode, idToIdType, isCollectionMembersAssignableTo, isStrict, leaveCriticalSection, removeProperty, removeProperty, removePropertyValueFromCollection, removePropertyValueFromCollection, replacePropertyValueCollection, setCopyManager, setPropertyValue, setPropertyValue, setStrict, toString, toTypedValue, updateAddPropertyValueToCollection, updateClearValueCollection, updatePropertyValue, updateRemoveProperty, updateRemovePropertyValueFromCollection, verify, verify, verify, verifyCollection

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Details

ExternalDocumentRef

public ExternalDocumentRef()
                    throws InvalidSPDXAnalysisException

Default model store, copy manager, and document URI

Throws:

InvalidSPDXAnalysisException

ExternalDocumentRef

public ExternalDocumentRef(String id)
                    throws InvalidSPDXAnalysisException

Parameters:

id -

Throws:

InvalidSPDXAnalysisException

ExternalDocumentRef

public ExternalDocumentRef(IModelStore modelStore,
 String documentUri,
 String id,
 @Nullable
 ModelCopyManager copyManager,
 boolean create)
                    throws InvalidSPDXAnalysisException

Parameters:

modelStore - Storage for the model objects

documentUri - SPDX Document URI for a document associated with this model

id - ID for this object - must be unique within the SPDX document

copyManager - - if supplied, model objects will be implicitly copied into this model store and document URI when referenced by setting methods

create - - if true, the object will be created in the store if it is not already present

Throws:

InvalidSPDXAnalysisException

Method Details

getExternalDocRefByDocNamespace

public static Optional<ExternalDocumentRef> getExternalDocRefByDocNamespace(IModelStore stModelStore,
 String stDocumentUri,
 String externalDocUri,
 @Nullable
 ModelCopyManager copyManager)
                                                                     throws InvalidSPDXAnalysisException

Obtain an ExternalDocumentRef which maps to the document URI for the external SPDX document.

Parameters:

stModelStore - Model Store for the document referring to the external SPDX document

stDocumentUri - Document URI for the document referring to the external SPDX document

externalDocUri - Document URI for the external document (a.k.a. eternalDocumentNamespace)

copyManager - if non-null, create the external Doc ref if it is not a property of the SPDX Document

Returns:

Throws:

InvalidSPDXAnalysisException

getType

public String getType()

Specified by:

getType in class ModelObject

Returns:

The class name for this object. Class names are defined in the constants file

getChecksum

public Optional<Checksum> getChecksum()
                               throws InvalidSPDXAnalysisException

Returns:

the checksum

Throws:

InvalidSPDXAnalysisException

setChecksum

public ExternalDocumentRef setChecksum(Checksum checksum)
                                throws InvalidSPDXAnalysisException

Parameters:

checksum - the checksum to set

Returns:

this to chain setters

Throws:

InvalidSPDXAnalysisException

getSpdxDocumentNamespace

public String getSpdxDocumentNamespace()
                                throws InvalidSPDXAnalysisException

Returns:

the spdxDocumentNamespace or empty string if no namespace

Throws:

InvalidSPDXAnalysisException

setSpdxDocumentNamespace

public ExternalDocumentRef setSpdxDocumentNamespace(String documentNamespace)
                                             throws InvalidSPDXAnalysisException

Set the document namespace

Parameters:

documentNamespace -

Throws:

InvalidSPDXAnalysisException

getSpdxDocument

public Optional<SpdxDocument> getSpdxDocument()
                                       throws InvalidSPDXAnalysisException

Returns the SPDX document if it exists within the same model store, otherwise it returns Optional.empty

Returns:

the spdxDocument

Throws:

InvalidSPDXAnalysisException

setSpdxDocument

public ExternalDocumentRef setSpdxDocument(SpdxDocument spdxDocument)
                                    throws InvalidSPDXAnalysisException

Parameters:

spdxDocument - the spdxDocument to set

Returns:

this to chain setters

Throws:

InvalidSPDXAnalysisException

_verify

protected List<String> _verify(Set<String> verifiedIds,
 String specVersion)

Description copied from class: ModelObject

Implementation of the specific verifications for this model object

Specified by:

_verify in class ModelObject

Parameters:

verifiedIds - list of all Element Id's which have already been verified - prevents infinite recursion

specVersion - Version of the SPDX spec to verify against

Returns:

Any verification errors or warnings associated with this object

compareTo

public int compareTo(ExternalDocumentRef o)

Specified by:

compareTo in interface Comparable<ExternalDocumentRef>