com.helger.commons.changelog

Class ChangeLog

java.lang.Object

com.helger.commons.changelog.ChangeLog

All Implemented Interfaces:

Serializable

@NotThreadSafe
public class ChangeLog
extends Object
implements Serializable

This class represents a single change log with a list of entries and releases.

Author:

Philip Helger

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ChangeLog(String sVersion, String sComponent) Constructor.

Method Summary

Modifier and Type	Method and Description
ICommonsList<AbstractChangeLogEntry>	entries()
boolean	equals(Object o)
ICommonsList<ChangeLogEntry>	getAllEntries()
ICommonsList<ChangeLogEntry>	getAllEntriesOfCategory(EChangeLogCategory eCategory) Get all change log entries, that match the specified category.
ICommonsList<ChangeLogRelease>	getAllReleases()
String	getComponent()
ChangeLogRelease	getLatestRelease()
String	getOriginalVersion()
Version	getVersion()
int	hashCode()
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

ChangeLog

public ChangeLog(@Nonnull @Nonempty
                 String sVersion,
                 @Nonnull @Nonempty
                 String sComponent)

Constructor.

Parameters:

sVersion - The change log version string.

sComponent - The name of the component the changelog belongs to.

Method Detail

getOriginalVersion

@Nonnull
 @Nonempty
public String getOriginalVersion()

Returns:

The original change log version. Never null.

getVersion

@Nonnull
public Version getVersion()

Returns:

The change log version. Never null.

getComponent

@Nonnull
 @Nonempty
public String getComponent()

Returns:

The name of the component, to which this change log belongs. Neither null nor empty.

entries

@Nonnull
 @ReturnsMutableObject
public ICommonsList<AbstractChangeLogEntry> entries()

Returns:

The internal modifiable list of entries. Never null.

Since:

9.0.0

getAllEntries

@Nonnull
 @ReturnsMutableCopy
public ICommonsList<ChangeLogEntry> getAllEntries()

Returns:

A modifiable list of all change log entries. Never null.

getAllEntriesOfCategory

@Nonnull
 @ReturnsMutableCopy
public ICommonsList<ChangeLogEntry> getAllEntriesOfCategory(@Nonnull
                                                                                            EChangeLogCategory eCategory)

Get all change log entries, that match the specified category.

Parameters:

eCategory - The category to search. May not be null.

Returns:

An empty list, if no change log entry matched the specified category. Never null.

getAllReleases

@Nonnull
 @ReturnsMutableCopy
public ICommonsList<ChangeLogRelease> getAllReleases()

Returns:

A list of all contained releases in this change log.

getLatestRelease

@Nullable
public ChangeLogRelease getLatestRelease()

Returns:

The release with the latest date. May be null if no release is contained.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object