org.cyclonedx.parsers

Class XmlParser

java.lang.Object

org.cyclonedx.CycloneDxSchema

org.cyclonedx.parsers.XmlParser

All Implemented Interfaces:

Parser

public class XmlParser
extends CycloneDxSchema
implements Parser

XmlParser is responsible for validating and parsing CycloneDX bill-of-material XML documents and returning a Bom object.

Since:

3.0.0

Field Summary

Fields inherited from class org.cyclonedx.CycloneDxSchema

ALL_VERSIONS, NS_BOM_10, NS_BOM_11, NS_BOM_12, NS_BOM_13, NS_BOM_14, NS_BOM_15, NS_BOM_16, NS_BOM_LATEST, NS_DEPENDENCY_GRAPH_10, VERSION_LATEST

Constructor Summary

Constructors

Constructor and Description
XmlParser()

Method Summary

Modifier and Type	Method and Description
boolean	isValid(byte[] bomBytes) Verifies a CycloneDX BOM conforms to the latest version of the specification.
boolean	isValid(byte[] bomBytes, Version schemaVersion) Verifies a CycloneDX BOM conforms to the specified specification version.
boolean	isValid(File file) Verifies a CycloneDX BOM conforms to the latest version of the specification.
boolean	isValid(File file, Version schemaVersion) Verifies a CycloneDX BOM conforms to the specified specification version.
boolean	isValid(InputStream inputStream) Verifies a CycloneDX BOM conforms to the latest version of the specification.
boolean	isValid(InputStream inputStream, Version schemaVersion) Verifies a CycloneDX BOM conforms to the specified specification version.
boolean	isValid(Reader reader) Verifies a CycloneDX BOM conforms to the latest version of the specification.
boolean	isValid(Reader reader, Version schemaVersion) Verifies a CycloneDX BOM conforms to the specified specification version.
Bom	parse(byte[] bomBytes) Parses a CycloneDX BOM.
Bom	parse(File file) Parses a CycloneDX BOM.
Bom	parse(InputStream inputStream) Parses a CycloneDX BOM.
Bom	parse(Reader reader) Parses a CycloneDX BOM.
List<ParseException>	validate(byte[] bomBytes) Validates a CycloneDX BOM.
List<ParseException>	validate(byte[] bomBytes, Version schemaVersion) Validates a CycloneDX BOM conforms to a specific specification version.
List<ParseException>	validate(File file) Validates a CycloneDX BOM.
List<ParseException>	validate(File file, Version schemaVersion) Validates a CycloneDX BOM conforms to a specific specification version.
List<ParseException>	validate(InputStream inputStream) Validates a CycloneDX BOM.
List<ParseException>	validate(InputStream inputStream, Version schemaVersion) Validates a CycloneDX BOM conforms to a specific specification version.
List<ParseException>	validate(Reader reader) Validates a CycloneDX BOM.
List<ParseException>	validate(Reader reader, Version schemaVersion) Validates a CycloneDX BOM conforms to a specific specification version.
List<ParseException>	validate(Source source, Version schemaVersion)

Methods inherited from class org.cyclonedx.CycloneDxSchema

getJsonSchema, getXmlSchema, getXmlSchema

Methods inherited from class java.lang.Object

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

Constructor Detail

XmlParser

public XmlParser()

Method Detail

parse

public Bom parse(File file)
          throws ParseException

Parses a CycloneDX BOM.

Specified by:

parse in interface Parser

Parameters:

file - a File to parse

Returns:

a Bom object

Throws:

ParseException - when errors are encountered

parse

public Bom parse(byte[] bomBytes)
          throws ParseException

Parses a CycloneDX BOM.

Specified by:

parse in interface Parser

Parameters:

bomBytes - the byte array to parse

Returns:

a Bom object

Throws:

ParseException - when errors are encountered

parse

public Bom parse(InputStream inputStream)
          throws ParseException

Parses a CycloneDX BOM.

Specified by:

parse in interface Parser

Parameters:

inputStream - the InputStream from which to parse

Returns:

a Bom object

Throws:

ParseException - when errors are encountered

parse

public Bom parse(Reader reader)
          throws ParseException

Parses a CycloneDX BOM.

Specified by:

parse in interface Parser

Parameters:

reader - the Reader from which to parse

Returns:

a Bom object

Throws:

ParseException - when errors are encountered

validate

public List<ParseException> validate(File file)
                              throws IOException

Validates a CycloneDX BOM.

Specified by:

validate in interface Parser

Parameters:

file - the CycloneDX BOM file to validate

Returns:

a List of ParseException. If the size of the list is 0, validation was successful

Throws:

IOException - when errors are encountered

validate

public List<ParseException> validate(File file,
                                     Version schemaVersion)
                              throws IOException

Validates a CycloneDX BOM conforms to a specific specification version.

Specified by:

validate in interface Parser

Parameters:

file - the CycloneDX BOM file to validate

schemaVersion - the schema version to validate against

Returns:

a List of ParseException. If the size of the list is 0, validation was successful

Throws:

IOException - when errors are encountered

validate

public List<ParseException> validate(byte[] bomBytes)
                              throws IOException

Validates a CycloneDX BOM.

Specified by:

validate in interface Parser

Parameters:

bomBytes - the byte array to validate

Returns:

a List of ParseException. If the size of the list is 0, validation was successful

Throws:

IOException - when errors are encountered

validate

public List<ParseException> validate(byte[] bomBytes,
                                     Version schemaVersion)
                              throws IOException

Validates a CycloneDX BOM conforms to a specific specification version.

Specified by:

validate in interface Parser

Parameters:

bomBytes - the byte array to validate

schemaVersion - the schema version to validate against

Returns:

a List of ParseException. If the size of the list is 0, validation was successful

Throws:

IOException - when errors are encountered

validate

public List<ParseException> validate(Reader reader)
                              throws IOException

Validates a CycloneDX BOM.

Specified by:

validate in interface Parser

Parameters:

reader - the Reader from which to parse

Returns:

a List of ParseException. If the size of the list is 0, validation was successful

Throws:

IOException - when errors are encountered

validate

public List<ParseException> validate(Reader reader,
                                     Version schemaVersion)
                              throws IOException

Validates a CycloneDX BOM conforms to a specific specification version.

Specified by:

validate in interface Parser

Parameters:

reader - the Reader from which to parse

schemaVersion - the schema version to validate against

Returns:

a List of ParseException. If the size of the list is 0, validation was successful

Throws:

IOException - when errors are encountered

validate

public List<ParseException> validate(InputStream inputStream)
                              throws IOException

Validates a CycloneDX BOM.

Specified by:

validate in interface Parser

Parameters:

inputStream - the InputStream from which to validate

Returns:

a List of ParseException. If the size of the list is 0, validation was successful

Throws:

IOException - when errors are encountered

validate

public List<ParseException> validate(InputStream inputStream,
                                     Version schemaVersion)
                              throws IOException

Validates a CycloneDX BOM conforms to a specific specification version.

Specified by:

validate in interface Parser

Parameters:

inputStream - the InputStream from which to validate

schemaVersion - the schema version to validate against

Returns:

a List of ParseException. If the size of the list is 0, validation was successful

Throws:

IOException - when errors are encountered

validate

public List<ParseException> validate(Source source,
                                     Version schemaVersion)
                              throws IOException

Throws:

IOException

isValid

public boolean isValid(File file)
                throws IOException

Verifies a CycloneDX BOM conforms to the latest version of the specification.

Specified by:

isValid in interface Parser

Parameters:

file - the CycloneDX BOM file to validate

Returns:

true if the file is a valid BOM, false if not

Throws:

IOException - when errors are encountered

isValid

public boolean isValid(File file,
                       Version schemaVersion)
                throws IOException

Verifies a CycloneDX BOM conforms to the specified specification version.

Specified by:

isValid in interface Parser

Parameters:

file - the CycloneDX BOM file to validate

schemaVersion - the schema version to validate against

Returns:

true if the file is a valid BOM, false if not

Throws:

IOException - when errors are encountered

isValid

public boolean isValid(byte[] bomBytes)
                throws IOException

Verifies a CycloneDX BOM conforms to the latest version of the specification.

Specified by:

isValid in interface Parser

Parameters:

bomBytes - the byte array to validate

Returns:

true if the file is a valid BOM, false if not

Throws:

IOException - when errors are encountered

isValid

public boolean isValid(byte[] bomBytes,
                       Version schemaVersion)
                throws IOException

Verifies a CycloneDX BOM conforms to the specified specification version.

Specified by:

isValid in interface Parser

Parameters:

bomBytes - the byte array to validate

schemaVersion - the schema version to validate against

Returns:

true if the file is a valid BOM, false if not

Throws:

IOException - when errors are encountered

isValid

public boolean isValid(Reader reader)
                throws IOException

Verifies a CycloneDX BOM conforms to the latest version of the specification.

Specified by:

isValid in interface Parser

Parameters:

reader - the Reader from which to validate

Returns:

true if the file is a valid BOM, false if not

Throws:

IOException - when errors are encountered

isValid

public boolean isValid(Reader reader,
                       Version schemaVersion)
                throws IOException

Verifies a CycloneDX BOM conforms to the specified specification version.

Specified by:

isValid in interface Parser

Parameters:

reader - the Reader from which to validate

schemaVersion - the schema version to validate against

Returns:

true if the file is a valid BOM, false if not

Throws:

IOException - when errors are encountered

isValid

public boolean isValid(InputStream inputStream)
                throws IOException

Verifies a CycloneDX BOM conforms to the latest version of the specification.

Specified by:

isValid in interface Parser

Parameters:

inputStream - the InputStream from which to validate

Returns:

true if the file is a valid BOM, false if not

Throws:

IOException - when errors are encountered

isValid

public boolean isValid(InputStream inputStream,
                       Version schemaVersion)
                throws IOException

Verifies a CycloneDX BOM conforms to the specified specification version.

Specified by:

isValid in interface Parser

Parameters:

inputStream - the InputStream from which to validate

schemaVersion - the schema version to validate against

Returns:

true if the file is a valid BOM, false if not

Throws:

IOException - when errors are encountered