org.rhq.enterprise.server.content
Interface ContentUIManagerLocal

All Known Implementing Classes:

ContentUIManagerBean

public interface ContentUIManagerLocal

EJB interface for operations that support the UI for the content subsystem.

Author:

Jason Dobies

Method Summary

org.rhq.core.domain.util.PageList<org.rhq.core.domain.content.InstalledPackageHistory>	findInstalledPackageHistoryByCriteria(org.rhq.core.domain.auth.Subject subject, org.rhq.core.domain.criteria.InstalledPackageHistoryCriteria criteria) Returns a pagable list of all package events that have taken place on the given resource.
org.rhq.core.domain.util.PageList<org.rhq.core.domain.content.ContentServiceRequest>	getContentRequestsWithNotStatus(org.rhq.core.domain.auth.Subject user, int resourceId, org.rhq.core.domain.content.ContentRequestStatus status, org.rhq.core.domain.util.PageControl pageControl) Returns a list of all content requests made against the specified resource that do not match the specified status.
org.rhq.core.domain.util.PageList<org.rhq.core.domain.content.ContentServiceRequest>	getContentRequestsWithStatus(org.rhq.core.domain.auth.Subject user, int resourceId, org.rhq.core.domain.content.ContentRequestStatus status, org.rhq.core.domain.util.PageControl pageControl) Returns a list of all content requests made against the specified resource that match the specified status.
org.rhq.core.domain.content.ContentServiceRequest	getContentServiceRequest(int requestId) Retrieves a content request by its ID.
org.rhq.core.domain.content.InstalledPackage	getInstalledPackage(int id) Loads the installed package identified by the ID from the database.
org.rhq.core.domain.content.InstalledPackageHistory	getInstalledPackageHistory(int historyId) Retrieves a specific history entry by its ID.
org.rhq.core.domain.util.PageList<org.rhq.core.domain.content.InstalledPackageHistory>	getInstalledPackageHistory(int contentServiceRequestId, org.rhq.core.domain.util.PageControl pc) Returns a list of installed package history entries that were created as a result of executing the indicated request.
org.rhq.core.domain.util.PageList<org.rhq.core.domain.content.InstalledPackageHistory>	getInstalledPackageHistory(org.rhq.core.domain.auth.Subject subject, int resourceId, int generalPackageId, org.rhq.core.domain.util.PageControl pc)
org.rhq.core.domain.util.PageList<org.rhq.core.domain.content.InstalledPackageHistory>	getInstalledPackageHistoryForResource(int resourceId, org.rhq.core.domain.util.PageControl pc) Returns a pagable list of all package events that have taken place on the given resource.
org.rhq.core.domain.util.PageList<org.rhq.core.domain.content.composite.PackageListItemComposite>	getInstalledPackages(org.rhq.core.domain.auth.Subject user, int resourceId, Integer packageTypeFilterId, String packageVersionFilter, String search, org.rhq.core.domain.util.PageControl pageControl) Returns a list of all installed packages on the specified resource.
List<org.rhq.core.domain.common.composite.IntegerOptionItem>	getInstalledPackageTypes(org.rhq.core.domain.auth.Subject user, int resourceId)
org.rhq.core.domain.content.composite.LoadedPackageBitsComposite	getLoadedPackageBitsComposite(int packageVersionId) This will return a composite object that tells you if the actual content (the "bits") for a particular package version is loaded into inventory or not, and, if the content is loaded, whether or not that content is stored in the database.
org.rhq.core.domain.content.PackageInstallationStep	getPackageInstallationStep(int stepId) Retrieves a specific step entry by its ID.
List<org.rhq.core.domain.content.PackageInstallationStep>	getPackageInstallationSteps(int installedPackageHistoryId) Retrieves the individual steps executed during the specified package installation history.
org.rhq.core.domain.content.PackageType	getPackageType(int id) Loads the package type identified by the ID from the database.
List<org.rhq.core.domain.content.PackageType>	getPackageTypes()
List<org.rhq.core.domain.content.PackageType>	getPackageTypes(int resourceTypeId) Returns all package types that are available to the specified resource type.
org.rhq.core.domain.util.PageList<org.rhq.core.domain.content.PackageType>	getPackageTypes(int resourceTypeId, org.rhq.core.domain.util.PageControl pageControl) Returns all package types that are available to the specified resource type in a page control.
org.rhq.core.domain.content.PackageVersion	getPackageVersion(int packageVersionId) Retrieves a package version by its ID.
List<org.rhq.core.domain.content.composite.PackageVersionComposite>	getPackageVersionComposites(org.rhq.core.domain.auth.Subject user, int[] packageVersionIds) Used to retrieve information about multiple packages to display to the user.
org.rhq.core.domain.util.PageList<org.rhq.core.domain.content.composite.PackageVersionComposite>	getPackageVersionComposites(org.rhq.core.domain.auth.Subject user, int[] packageVersionIds, org.rhq.core.domain.util.PageControl pageControl) Used to retrieve information about multiple packages to display to the user.
org.rhq.core.domain.util.PageList<org.rhq.core.domain.content.composite.PackageVersionComposite>	getPackageVersionCompositesByFilter(org.rhq.core.domain.auth.Subject user, int resourceId, String filter, org.rhq.core.domain.util.PageControl pc)
org.rhq.core.domain.util.PageList<org.rhq.core.domain.content.composite.PackageVersionComposite>	getUpdatePackageVersionCompositesByFilter(org.rhq.core.domain.auth.Subject user, int resourceId, String filter, org.rhq.core.domain.util.PageControl pc)
org.rhq.core.domain.content.composite.AdvisoryDetailsComposite	loadAdvisoryDetailsComposite(org.rhq.core.domain.auth.Subject user, Integer id) Retrieves Advisory Details by its ID.
org.rhq.core.domain.content.composite.PackageVersionComposite	loadPackageVersionComposite(org.rhq.core.domain.auth.Subject user, int packageVersionId) Used to retrieve information about a package version to display to a user.
org.rhq.core.domain.content.composite.PackageVersionComposite	loadPackageVersionCompositeWithExtraProperties(org.rhq.core.domain.auth.Subject user, int packageVersionId) Used to retrieve information about a package version to display to a user.

Method Detail

getLoadedPackageBitsComposite

org.rhq.core.domain.content.composite.LoadedPackageBitsComposite getLoadedPackageBitsComposite(int packageVersionId)

This will return a composite object that tells you if the actual content (the "bits") for a particular package version is loaded into inventory or not, and, if the content is loaded, whether or not that content is stored in the database.

Parameters:

packageVersionId - the PackageVersion identifier

Returns:

indicates if the package version content is loaded and available

See Also:

LoadedPackageBitsComposite

getInstalledPackage

org.rhq.core.domain.content.InstalledPackage getInstalledPackage(int id)

Loads the installed package identified by the ID from the database.

Parameters:

id - identifies the installed package

Returns:

installed package if one exists; null otherwise

getInstalledPackageTypes

List<org.rhq.core.domain.common.composite.IntegerOptionItem> getInstalledPackageTypes(org.rhq.core.domain.auth.Subject user,
                                                                                      int resourceId)

getPackageType

org.rhq.core.domain.content.PackageType getPackageType(int id)

Loads the package type identified by the ID from the database.

Parameters:

id - package type to load

Returns:

package type if one exists for the ID; null otherwise

getPackageTypes

List<org.rhq.core.domain.content.PackageType> getPackageTypes()

Returns:

all package types

getPackageTypes

List<org.rhq.core.domain.content.PackageType> getPackageTypes(int resourceTypeId)

Returns all package types that are available to the specified resource type.

Parameters:

resourceTypeId - identifies the resource type

Returns:

set of package types

getPackageTypes

org.rhq.core.domain.util.PageList<org.rhq.core.domain.content.PackageType> getPackageTypes(int resourceTypeId,
                                                                                           org.rhq.core.domain.util.PageControl pageControl)

Returns all package types that are available to the specified resource type in a page control.

Parameters:

resourceTypeId - identifies the resource type

pageControl - paging control

Returns:

pagable list of package types

getContentRequestsWithStatus

org.rhq.core.domain.util.PageList<org.rhq.core.domain.content.ContentServiceRequest> getContentRequestsWithStatus(org.rhq.core.domain.auth.Subject user,
                                                                                                                  int resourceId,
                                                                                                                  org.rhq.core.domain.content.ContentRequestStatus status,
                                                                                                                  org.rhq.core.domain.util.PageControl pageControl)

Returns a list of all content requests made against the specified resource that match the specified status.

Parameters:

user - the user who is requesting the retrieval

resourceId - identifies the resource whose requests to retrieve

status - request status being matched

pageControl - pagination controller

Returns:

list of artifact requests for the specified resource

getContentRequestsWithNotStatus

org.rhq.core.domain.util.PageList<org.rhq.core.domain.content.ContentServiceRequest> getContentRequestsWithNotStatus(org.rhq.core.domain.auth.Subject user,
                                                                                                                     int resourceId,
                                                                                                                     org.rhq.core.domain.content.ContentRequestStatus status,
                                                                                                                     org.rhq.core.domain.util.PageControl pageControl)

Returns a list of all content requests made against the specified resource that do not match the specified status.

Parameters:

user - the user who is requesting the retrieval

resourceId - identifies the resource whose requests to retrieve

status - request status to not match

pageControl - pagination controller

Returns:

list of content requests for the specified resource

getInstalledPackages

org.rhq.core.domain.util.PageList<org.rhq.core.domain.content.composite.PackageListItemComposite> getInstalledPackages(org.rhq.core.domain.auth.Subject user,
                                                                                                                       int resourceId,
                                                                                                                       Integer packageTypeFilterId,
                                                                                                                       String packageVersionFilter,
                                                                                                                       String search,
                                                                                                                       org.rhq.core.domain.util.PageControl pageControl)

Returns a list of all installed packages on the specified resource.

Parameters:

user - the user who is requesting the retrieval

resourceId - identifies the resource whose requests to retrieve

search - string to search against filtering by name or description

pageControl - pagination controller

Returns:

pagable list of packages installed on the resource

getInstalledPackageHistory

org.rhq.core.domain.util.PageList<org.rhq.core.domain.content.InstalledPackageHistory> getInstalledPackageHistory(org.rhq.core.domain.auth.Subject subject,
                                                                                                                  int resourceId,
                                                                                                                  int generalPackageId,
                                                                                                                  org.rhq.core.domain.util.PageControl pc)

getPackageVersionCompositesByFilter

org.rhq.core.domain.util.PageList<org.rhq.core.domain.content.composite.PackageVersionComposite> getPackageVersionCompositesByFilter(org.rhq.core.domain.auth.Subject user,
                                                                                                                                     int resourceId,
                                                                                                                                     String filter,
                                                                                                                                     org.rhq.core.domain.util.PageControl pc)

getUpdatePackageVersionCompositesByFilter

org.rhq.core.domain.util.PageList<org.rhq.core.domain.content.composite.PackageVersionComposite> getUpdatePackageVersionCompositesByFilter(org.rhq.core.domain.auth.Subject user,
                                                                                                                                           int resourceId,
                                                                                                                                           String filter,
                                                                                                                                           org.rhq.core.domain.util.PageControl pc)

loadPackageVersionComposite

org.rhq.core.domain.content.composite.PackageVersionComposite loadPackageVersionComposite(org.rhq.core.domain.auth.Subject user,
                                                                                          int packageVersionId)

Used to retrieve information about a package version to display to a user.

Parameters:

user - user who wants to see the information

packageVersionId - identifies what package version to return info on

Returns:

the information on the package version

loadPackageVersionCompositeWithExtraProperties

org.rhq.core.domain.content.composite.PackageVersionComposite loadPackageVersionCompositeWithExtraProperties(org.rhq.core.domain.auth.Subject user,
                                                                                                             int packageVersionId)

Used to retrieve information about a package version to display to a user. This call will also load the extra properties configuration object on the package version.

Parameters:

user - user who wants to see the information

packageVersionId - identifies what package version to return info on

Returns:

the information on the package version

getPackageVersionComposites

List<org.rhq.core.domain.content.composite.PackageVersionComposite> getPackageVersionComposites(org.rhq.core.domain.auth.Subject user,
                                                                                                int[] packageVersionIds)

Used to retrieve information about multiple packages to display to the user.

Parameters:

user - user who wants to see the information

packageVersionIds - identifies what package versions to return info on

Returns:

package version information for each package identified

getPackageVersionComposites

org.rhq.core.domain.util.PageList<org.rhq.core.domain.content.composite.PackageVersionComposite> getPackageVersionComposites(org.rhq.core.domain.auth.Subject user,
                                                                                                                             int[] packageVersionIds,
                                                                                                                             org.rhq.core.domain.util.PageControl pageControl)

Used to retrieve information about multiple packages to display to the user.

Parameters:

user - user who wants to see the information

packageVersionIds - identifies what package versions to return info on

pageControl - pagination controller

Returns:

package version information for each package identified

getPackageVersion

org.rhq.core.domain.content.PackageVersion getPackageVersion(int packageVersionId)

Retrieves a package version by its ID. One and only one package version must exist for the ID; an error will be thrown if exactly one package version is not found.

Parameters:

packageVersionId - identifies the package version

Returns:

package version entity

getContentServiceRequest

org.rhq.core.domain.content.ContentServiceRequest getContentServiceRequest(int requestId)

Retrieves a content request by its ID. One and only one content request must exist for the ID; an error will be thrown if exactly one content request is not found.

Parameters:

requestId - identifies the request

Returns:

content request entity

getInstalledPackageHistory

org.rhq.core.domain.util.PageList<org.rhq.core.domain.content.InstalledPackageHistory> getInstalledPackageHistory(int contentServiceRequestId,
                                                                                                                  org.rhq.core.domain.util.PageControl pc)

Returns a list of installed package history entries that were created as a result of executing the indicated request.

Parameters:

contentServiceRequestId - identifies the request that caused the history entries

pc - pagination controller

Returns:

list of history entries

getInstalledPackageHistory

org.rhq.core.domain.content.InstalledPackageHistory getInstalledPackageHistory(int historyId)

Retrieves a specific history entry by its ID. One and only one history entry must exist for the ID; an error will be thrown if exactly one history entry is not found.

Parameters:

historyId - identifies the history entry

Returns:

history entry

getPackageInstallationSteps

List<org.rhq.core.domain.content.PackageInstallationStep> getPackageInstallationSteps(int installedPackageHistoryId)

Retrieves the individual steps executed during the specified package installation history.

Parameters:

installedPackageHistoryId - identifies the history entry

Returns:

list of steps; empty list if there were no steps reported

getPackageInstallationStep

org.rhq.core.domain.content.PackageInstallationStep getPackageInstallationStep(int stepId)

Retrieves a specific step entry by its ID.

Parameters:

stepId - identifies the step to retrieve

Returns:

step entry

getInstalledPackageHistoryForResource

org.rhq.core.domain.util.PageList<org.rhq.core.domain.content.InstalledPackageHistory> getInstalledPackageHistoryForResource(int resourceId,
                                                                                                                             org.rhq.core.domain.util.PageControl pc)

Returns a pagable list of all package events that have taken place on the given resource.

Parameters:

resourceId - must refer to a valid resource in the database

pc - pagination controller

Returns:

pagable list of package change items; will not be null

findInstalledPackageHistoryByCriteria

org.rhq.core.domain.util.PageList<org.rhq.core.domain.content.InstalledPackageHistory> findInstalledPackageHistoryByCriteria(org.rhq.core.domain.auth.Subject subject,
                                                                                                                             org.rhq.core.domain.criteria.InstalledPackageHistoryCriteria criteria)

Returns a pagable list of all package events that have taken place on the given resource.

Parameters:

resourceId - must refer to a valid resource in the database

pc - pagination controller

Returns:

pagable list of package change items; will not be null

loadAdvisoryDetailsComposite

org.rhq.core.domain.content.composite.AdvisoryDetailsComposite loadAdvisoryDetailsComposite(org.rhq.core.domain.auth.Subject user,
                                                                                            Integer id)

Retrieves Advisory Details by its ID. One and only one must exist for the ID;

Parameters:

user - user who wants to see the information

id - identifier for advisory

Returns:

AdvisoryDetailsComposite entity