Package com.github.packageurl

Class PackageURLBuilder

java.lang.Object

com.github.packageurl.PackageURLBuilder

public final class PackageURLBuilder
extends java.lang.Object

A builder construct for Package-URL objects.

Field Summary

Fields

Modifier and Type	Field	Description
private java.lang.String	name
private java.lang.String	namespace
private java.util.TreeMap<java.lang.String,java.lang.String>	qualifiers
private java.lang.String	subpath
private java.lang.String	type
private java.lang.String	version

Constructor Summary

Constructors

Modifier	Constructor	Description
private	PackageURLBuilder()

Method Summary

Modifier and Type	Method	Description
static PackageURLBuilder	aPackageURL()	Obtain a reference to a new builder object.
PackageURL	build()	Builds the new PackageURL object.
java.lang.String	getName()	Returns current name value set in the builder.
java.lang.String	getNamespace()	Returns current namespace value set in the builder.
java.lang.String	getQualifier(java.lang.String key)	Returns a currently set qualifier value set in the builder for the specified key.
java.util.TreeMap<java.lang.String,java.lang.String>	getQualifiers()	Returns sorted map containing all qualifiers set in this builder.
java.lang.String	getSubpath()	Returns current subpath value set in the builder.
java.lang.String	getType()	Returns current type value set in the builder.
java.lang.String	getVersion()	Returns current version value set in the builder.
PackageURLBuilder	withName(java.lang.String name)	Adds the package name.
PackageURLBuilder	withNamespace(java.lang.String namespace)	Adds the package namespace.
PackageURLBuilder	withNoQualifiers()	Removes all qualifiers, if any.
PackageURLBuilder	withoutQualifier(java.lang.String key)	Removes a package qualifier.
PackageURLBuilder	withQualifier(java.lang.String key, java.lang.String value)	Adds a package qualifier.
PackageURLBuilder	withSubpath(java.lang.String subpath)	Adds the package subpath.
PackageURLBuilder	withType(java.lang.String type)	Adds the package URL type.
PackageURLBuilder	withVersion(java.lang.String version)	Adds the package version.

Methods inherited from class java.lang.Object

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

Field Detail

type

private java.lang.String type

namespace

private java.lang.String namespace

name

private java.lang.String name

version

private java.lang.String version

subpath

private java.lang.String subpath

qualifiers

private java.util.TreeMap<java.lang.String,java.lang.String> qualifiers

Constructor Detail

PackageURLBuilder

private PackageURLBuilder()

Method Detail

aPackageURL

public static PackageURLBuilder aPackageURL()

Obtain a reference to a new builder object.

Returns:

a new builder object.

withType

public PackageURLBuilder withType(java.lang.String type)

Adds the package URL type.

Parameters:

type - the package type

Returns:

a reference to the builder

See Also:

PackageURL.getName(), PackageURL.StandardTypes

withNamespace

public PackageURLBuilder withNamespace(java.lang.String namespace)

Adds the package namespace.

Parameters:

namespace - the package namespace

Returns:

a reference to the builder

See Also:

PackageURL.getNamespace()

withName

public PackageURLBuilder withName(java.lang.String name)

Adds the package name.

Parameters:

name - the package name

Returns:

a reference to the builder

See Also:

PackageURL.getName()

withVersion

public PackageURLBuilder withVersion(java.lang.String version)

Adds the package version.

Parameters:

version - the package version

Returns:

a reference to the builder

See Also:

PackageURL.getVersion()

withSubpath

public PackageURLBuilder withSubpath(java.lang.String subpath)

Adds the package subpath.

Parameters:

subpath - the package subpath

Returns:

a reference to the builder

See Also:

PackageURL.getSubpath()

withQualifier

public PackageURLBuilder withQualifier(java.lang.String key,
                                       java.lang.String value)

Adds a package qualifier.

Parameters:

key - the package qualifier key

value - the package qualifier value

Returns:

a reference to the builder

See Also:

PackageURL.getQualifiers()

withoutQualifier

public PackageURLBuilder withoutQualifier(java.lang.String key)

Removes a package qualifier. This is a no-op if the qualifier is not present.

Parameters:

key - the package qualifier key to remove

Returns:

a reference to the builder

withNoQualifiers

public PackageURLBuilder withNoQualifiers()

Removes all qualifiers, if any.

Returns:

a reference to this builder.

getType

public java.lang.String getType()

Returns current type value set in the builder.

Returns:

type set in this builder

getNamespace

public java.lang.String getNamespace()

Returns current namespace value set in the builder.

Returns:

namespace set in this builder

getName

public java.lang.String getName()

Returns current name value set in the builder.

Returns:

name set in this builder

getVersion

public java.lang.String getVersion()

Returns current version value set in the builder.

Returns:

version set in this builder

getSubpath

public java.lang.String getSubpath()

Returns current subpath value set in the builder.

Returns:

subpath set in this builder

getQualifiers

public java.util.TreeMap<java.lang.String,java.lang.String> getQualifiers()

Returns sorted map containing all qualifiers set in this builder. An empty map is returned if no qualifiers is set.

Returns:

all qualifiers set in this builder, or an empty map if none are set.

getQualifier

public java.lang.String getQualifier(java.lang.String key)

Returns a currently set qualifier value set in the builder for the specified key.

Parameters:

key - qualifier key

Returns:

qualifier value or null if one is not set.

build

public PackageURL build()
                 throws MalformedPackageURLException

Builds the new PackageURL object.

Returns:

the new PackageURL object

Throws:

MalformedPackageURLException - thrown if the type or name has not been specified or if a field fails validation