Package org.apache.maven.api.model
Class Contributor
java.lang.Object
org.apache.maven.api.model.Contributor
- All Implemented Interfaces:
Serializable
,InputLocationTracker
- Direct Known Subclasses:
Developer
@Experimental
@Generated
@ThreadSafe
@Immutable
public class Contributor
extends Object
implements Serializable, InputLocationTracker
Description of a person who has contributed to the project, but who does not have
commit privileges. Usually, these contributions come in the form of patches submitted.
- See Also:
-
Nested Class Summary
Modifier and TypeClassDescriptionstatic class
Builder class used to create Contributor instances. -
Constructor Summary
ModifierConstructorDescriptionprotected
Contributor
(Contributor.Builder builder) Constructor for this class, to be called from its subclasses andContributor.Builder
. -
Method Summary
Modifier and TypeMethodDescriptiongetEmail()
The email address of the contributor.Gets the input location that caused this model to be read.getLocation
(Object key) Gets the location of the specified field in the input source.Gets the keys of the locations of the input source.getName()
The full name of the contributor.The organization to which the contributor belongs.The URL of the organization.Properties about the contributor, such as an instant messenger handle.getRoles()
The roles the contributor plays in the project.The timezone the contributor is in.getUrl()
The URL for the homepage of the contributor.static Contributor.Builder
Creates a newContributor
builder instance.static Contributor.Builder
newBuilder
(boolean withDefaults) Creates a newContributor
builder instance using default values or not.static Contributor.Builder
newBuilder
(Contributor from) Creates a newContributor
builder instance using the specified object as a basis.static Contributor.Builder
newBuilder
(Contributor from, boolean forceCopy) Creates a newContributor
builder instance using the specified object as a basis.static Contributor
Creates a newContributor
instance.static Contributor
newInstance
(boolean withDefaults) Creates a newContributor
instance using default values or not.toString()
with()
Creates a new builder with this object as the basis.Creates a newContributor
instance using the specified email.Creates a newContributor
instance using the specified name.withOrganization
(String organization) Creates a newContributor
instance using the specified organization.withOrganizationUrl
(String organizationUrl) Creates a newContributor
instance using the specified organizationUrl.withProperties
(Map<String, String> properties) Creates a newContributor
instance using the specified properties.withRoles
(Collection<String> roles) Creates a newContributor
instance using the specified roles.withTimezone
(String timezone) Creates a newContributor
instance using the specified timezone.Creates a newContributor
instance using the specified url.
-
Constructor Details
-
Contributor
Constructor for this class, to be called from its subclasses andContributor.Builder
.- See Also:
-
-
Method Details
-
getName
The full name of the contributor.- Returns:
- a
String
-
getEmail
The email address of the contributor.- Returns:
- a
String
-
getUrl
The URL for the homepage of the contributor.- Returns:
- a
String
-
getOrganization
The organization to which the contributor belongs.- Returns:
- a
String
-
getOrganizationUrl
The URL of the organization.- Returns:
- a
String
-
getRoles
The roles the contributor plays in the project. Each role is described by arole
element, the body of which is a role name. This can also be used to describe the contribution.- Returns:
- a
List<String>
-
getTimezone
The timezone the contributor is in. Typically, this is a number in the range -12 to +14 or a valid time zone id like "America/Montreal" (UTC-05:00) or "Europe/Paris" (UTC+01:00).- Returns:
- a
String
-
getProperties
Properties about the contributor, such as an instant messenger handle.- Returns:
- a
Map<String, String>
-
getLocation
Gets the location of the specified field in the input source.- Specified by:
getLocation
in interfaceInputLocationTracker
-
getLocationKeys
Gets the keys of the locations of the input source. -
getLocationKeyStream
-
getImportedFrom
Gets the input location that caused this model to be read.- Specified by:
getImportedFrom
in interfaceInputLocationTracker
- Returns:
- InputLocation
-
with
Creates a new builder with this object as the basis.- Returns:
- a
Builder
-
withName
Creates a newContributor
instance using the specified name.- Parameters:
name
- the newString
to use- Returns:
- a
Contributor
with the specified name
-
withEmail
Creates a newContributor
instance using the specified email.- Parameters:
email
- the newString
to use- Returns:
- a
Contributor
with the specified email
-
withUrl
Creates a newContributor
instance using the specified url.- Parameters:
url
- the newString
to use- Returns:
- a
Contributor
with the specified url
-
withOrganization
Creates a newContributor
instance using the specified organization.- Parameters:
organization
- the newString
to use- Returns:
- a
Contributor
with the specified organization
-
withOrganizationUrl
Creates a newContributor
instance using the specified organizationUrl.- Parameters:
organizationUrl
- the newString
to use- Returns:
- a
Contributor
with the specified organizationUrl
-
withRoles
Creates a newContributor
instance using the specified roles.- Parameters:
roles
- the newCollection<String>
to use- Returns:
- a
Contributor
with the specified roles
-
withTimezone
Creates a newContributor
instance using the specified timezone.- Parameters:
timezone
- the newString
to use- Returns:
- a
Contributor
with the specified timezone
-
withProperties
Creates a newContributor
instance using the specified properties.- Parameters:
properties
- the newMap<String, String>
to use- Returns:
- a
Contributor
with the specified properties
-
newInstance
Creates a newContributor
instance. Equivalent tonewInstance(true)
.- Returns:
- a new
Contributor
- See Also:
-
newInstance
Creates a newContributor
instance using default values or not. Equivalent tonewBuilder(withDefaults).build()
.- Parameters:
withDefaults
- the boolean indicating whether default values should be used- Returns:
- a new
Contributor
-
newBuilder
Creates a newContributor
builder instance. Equivalent tonewBuilder(true)
.- Returns:
- a new
Builder
- See Also:
-
newBuilder
Creates a newContributor
builder instance using default values or not.- Parameters:
withDefaults
- the boolean indicating whether default values should be used- Returns:
- a new
Builder
-
newBuilder
Creates a newContributor
builder instance using the specified object as a basis. Equivalent tonewBuilder(from, false)
.- Parameters:
from
- theContributor
instance to use as a basis- Returns:
- a new
Builder
-
newBuilder
Creates a newContributor
builder instance using the specified object as a basis.- Parameters:
from
- theContributor
instance to use as a basisforceCopy
- the boolean indicating if a copy should be forced- Returns:
- a new
Builder
-
toString
-