com.redhat.rhn.domain.rhnpackage

Class PackageFactory

java.lang.Object

com.redhat.rhn.common.hibernate.HibernateFactory

com.redhat.rhn.domain.rhnpackage.PackageFactory

public class PackageFactory
extends HibernateFactory

PackageFactory

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ARCH_TYPE_RPM
static java.lang.String	ARCH_TYPE_TAR
static PackageKeyType	PACKAGE_KEY_TYPE_GPG

Method Summary

Modifier and Type	Method and Description
static void	deletePackage(Package pack) Deletes a particular package object from hibernate.
static void	deletePackageKey(PackageKey key) Deletes a package key
static void	deletePackageSource(PackageSource src) Deletes a particular package source object
static java.util.List<Package>	findPackagesWithDifferentArch(Package pack) Find other packages with the same NVRE but with different arches
static java.util.List<java.util.Map<java.lang.String,java.lang.String>>	getErrataChannelIntersection(java.lang.Long cid, java.lang.Long eid, boolean published) Returns package names that are shared between an erratum and a channel, with string representations of the versions in each.
protected org.apache.log4j.Logger	getLogger() Get the Logger for the derived class so log messages show up on the correct class
static java.util.Map<java.lang.String,java.util.Set<java.lang.String>>	getPackageCapabilityMap() Provides a mapping of arch type labels to sets of capabilities (ported from the if statement mess in package_type_capable of Package.pm).
static DataResult	getPackagesChannelArchCompatAndOrgAccess(java.lang.Long orgId, java.lang.Long channelId, java.util.List<java.lang.Long> packageIds) Returns information, whether each package in the list is channel compatible and whether the org has accesds to
static boolean	isPackageInChannel(java.lang.Long cid, java.lang.Long nameId, java.lang.Long evrId) Returns true if the Package with the given name and evr ids exists in the Channel whose id is cid.
static java.util.List<PackageKey>	listPackageKeys() List all package keys
static java.util.List<PackageProvider>	listPackageProviders() list package providers
static java.util.List	listPackagesByPackageName(PackageName pn) List the Package objects by their Package Name
static Package	lookupByIdAndOrg(java.lang.Long id, Org org) Lookup a Package by the id, in the context of a given org.
static Package	lookupByIdAndUser(java.lang.Long id, User user) Lookup a Package by the id, in the context of a given user.
static InstalledPackage	lookupByNameAndServer(java.lang.String name, Server server) Returns an InstalledPackage object, given a server and package name to lookup the latest version of the package.
static java.util.List<Package>	lookupByNevra(Org org, java.lang.String name, java.lang.String version, java.lang.String release, java.lang.String epoch, PackageArch arch) Find a package based off of the NEVRA
static PackageKeyType	lookupKeyTypeByLabel(java.lang.String label) Lookup a package key type by label
static PackageName	lookupOrCreatePackageByName(java.lang.String pn) lookup a PackageName object based on it's name, If one does not exist, create a new one and return it.
static java.util.List	lookupOrphanPackages(Org org) lookup orphaned packages, i.e.
static PackageArch	lookupPackageArchById(java.lang.Long id) Lookup a PackageArch by its id.
static PackageArch	lookupPackageArchByLabel(java.lang.String label) Lookup a PackageArch by its label.
static PackageKey	lookupPackageKey(java.lang.String key) Lookup a package key object
static PackageName	lookupPackageName(java.lang.Long id) lookup a PackageName object based on it's id, returns null if it does not exist
static PackageName	lookupPackageName(java.lang.String pn) lookup a PackageName object based on it's name, returns null if it does not exist
static PackageProvider	lookupPackageProvider(java.lang.String name) Looup a package provider by name
static PackageSource	lookupPackageSourceByIdAndOrg(java.lang.Long psid, Org org) Lookup package source by it's ID
static java.util.List<PackageSource>	lookupPackageSources(Package pack) Lookup package sources for a particular package
static java.util.List<PackageOverview>	packageSearch(java.util.List<java.lang.Long> pids, java.util.List<java.lang.String> archLabels, java.lang.Long relevantUserId, java.lang.Long filterChannelId, java.lang.String searchType) Returns PackageOverviews from a search.
static void	save(PackageDelta delta) Store the package delta.
static void	save(PackageProvider prov) Store the package provider.

Methods inherited from class com.redhat.rhn.common.hibernate.HibernateFactory

addConfigurator, blobToByteArray, byteArrayToBlob, closeSession, closeSessionFactory, commitTransaction, createSessionFactory, createSessionFactory, executeCallableMode, executeSelectMode, getBlobContents, getByteArrayContents, getObject, getSession, initialize, inTransaction, isClosed, isInitialized, listObjectsByNamedQuery, listObjectsByNamedQuery, listObjectsByNamedQuery, lockObject, lookupObjectByNamedQuery, lookupObjectByNamedQuery, reload, removeObject, rollbackTransaction, saveObject, saveObject, stringToByteArray

Methods inherited from class java.lang.Object

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

Field Detail

PACKAGE_KEY_TYPE_GPG

public static final PackageKeyType PACKAGE_KEY_TYPE_GPG

ARCH_TYPE_RPM

public static final java.lang.String ARCH_TYPE_RPM

See Also:

Constant Field Values

ARCH_TYPE_TAR

public static final java.lang.String ARCH_TYPE_TAR

See Also:

Constant Field Values

Method Detail

getLogger

protected org.apache.log4j.Logger getLogger()

Get the Logger for the derived class so log messages show up on the correct class

Specified by:

getLogger in class HibernateFactory

Returns:

Logger for this class.

isPackageInChannel

public static boolean isPackageInChannel(java.lang.Long cid,
                                         java.lang.Long nameId,
                                         java.lang.Long evrId)

Returns true if the Package with the given name and evr ids exists in the Channel whose id is cid.

Parameters:

cid - Channel id to look in

nameId - Package name id

evrId - Package evr id

Returns:

true if the Package with the given name and evr ids exists in the Channel whose id is cid.

lookupByIdAndUser

public static Package lookupByIdAndUser(java.lang.Long id,
                                        User user)

Lookup a Package by the id, in the context of a given user. Does security check to verify that the user has access to the package.

Parameters:

id - of the Package to search for

user - the user doing the search

Returns:

the Package found

lookupByIdAndOrg

public static Package lookupByIdAndOrg(java.lang.Long id,
                                       Org org)

Lookup a Package by the id, in the context of a given org. Does security check to verify that the org has access to the package.

Parameters:

id - of the Package to search for

org - the org which much have access to the package

Returns:

the Package found

save

public static void save(PackageProvider prov)

Store the package provider.

Parameters:

prov - The object we are commiting.

save

public static void save(PackageDelta delta)

Store the package delta.

Parameters:

delta - The object we are commiting.

lookupPackageArchById

public static PackageArch lookupPackageArchById(java.lang.Long id)

Lookup a PackageArch by its id.

Parameters:

id - package arch label id sought.

Returns:

the PackageArch whose id matches the given id.

lookupPackageArchByLabel

public static PackageArch lookupPackageArchByLabel(java.lang.String label)

Lookup a PackageArch by its label.

Parameters:

label - package arch label sought.

Returns:

the PackageArch whose label matches the given label.

listPackagesByPackageName

public static java.util.List listPackagesByPackageName(PackageName pn)

List the Package objects by their Package Name

Parameters:

pn - to query by

Returns:

List of Package objects if found

lookupOrCreatePackageByName

public static PackageName lookupOrCreatePackageByName(java.lang.String pn)

lookup a PackageName object based on it's name, If one does not exist, create a new one and return it.

Parameters:

pn - the package name

Returns:

a PackageName object that has a matching name

lookupPackageName

public static PackageName lookupPackageName(java.lang.Long id)

lookup a PackageName object based on it's id, returns null if it does not exist

Parameters:

id - the package name id

Returns:

a PackageName object that has a matching id or null if that doesn't exist

lookupPackageName

public static PackageName lookupPackageName(java.lang.String pn)

lookup a PackageName object based on it's name, returns null if it does not exist

Parameters:

pn - the package name

Returns:

a PackageName object that has a matching name or null if that doesn't exist

lookupOrphanPackages

public static java.util.List lookupOrphanPackages(Org org)

lookup orphaned packages, i.e. packages that are not contained in any channel

Parameters:

org - the org to check for

Returns:

a List of package objects that are not in any channel

lookupByNevra

public static java.util.List<Package> lookupByNevra(Org org,
                                                    java.lang.String name,
                                                    java.lang.String version,
                                                    java.lang.String release,
                                                    java.lang.String epoch,
                                                    PackageArch arch)

Find a package based off of the NEVRA

Parameters:

org - the org that owns the package

name - the name to search for

version - the version to search for

release - the release to search for

epoch - if epoch is null, the best match for epoch will be used.

arch - the arch to search for

Returns:

the requested Package

lookupByNameAndServer

public static InstalledPackage lookupByNameAndServer(java.lang.String name,
                                                     Server server)

Returns an InstalledPackage object, given a server and package name to lookup the latest version of the package. Return null if the package doesn;t exist.

Parameters:

name - name of the package to lookup on

server - server where the give package was installed.

Returns:

the InstalledPackage with the given package name for the given server

packageSearch

public static java.util.List<PackageOverview> packageSearch(java.util.List<java.lang.Long> pids,
                                                            java.util.List<java.lang.String> archLabels,
                                                            java.lang.Long relevantUserId,
                                                            java.lang.Long filterChannelId,
                                                            java.lang.String searchType)

Returns PackageOverviews from a search.

Parameters:

pids - List of package ids returned from search server.

archLabels - List of channel arch labels.

relevantUserId - user id to filter by if relevant or architecture search server the user can see is subscribed to

filterChannelId - channel id to filter by if channel search

searchType - type of search to do, one of "relevant", "channel", "architecture", or "all"

Returns:

PackageOverviews from a search.

lookupKeyTypeByLabel

public static PackageKeyType lookupKeyTypeByLabel(java.lang.String label)

Lookup a package key type by label

Parameters:

label - the label of the type

Returns:

the key type

deletePackage

public static void deletePackage(Package pack)

Deletes a particular package object from hibernate. Note, currently This does not delete it from rhnServerNeededPackageCache so you probably want to use SystemManager.deletePackages() to do that instead. This does not also cleanup rhNPackageSource entries

Parameters:

pack - the package to delete

deletePackageSource

public static void deletePackageSource(PackageSource src)

Deletes a particular package source object

Parameters:

src - the package source object

lookupPackageSources

public static java.util.List<PackageSource> lookupPackageSources(Package pack)

Lookup package sources for a particular package

Parameters:

pack - the package associated with the package sources

Returns:

the list of package source objects

lookupPackageSourceByIdAndOrg

public static PackageSource lookupPackageSourceByIdAndOrg(java.lang.Long psid,
                                                          Org org)

Lookup package source by it's ID

Parameters:

psid - id of the source package

org - the org with access to the source package

Returns:

the package source

findPackagesWithDifferentArch

public static java.util.List<Package> findPackagesWithDifferentArch(Package pack)

Find other packages with the same NVRE but with different arches

Parameters:

pack - the package

Returns:

List of package objects

getPackageCapabilityMap

public static java.util.Map<java.lang.String,java.util.Set<java.lang.String>> getPackageCapabilityMap()

Provides a mapping of arch type labels to sets of capabilities (ported from the if statement mess in package_type_capable of Package.pm). This should really be in the DB, but it's not :{ and it needs to be ported from perl.

Returns:

the map of arch label -> set of capabilities

listPackageProviders

public static java.util.List<PackageProvider> listPackageProviders()

list package providers

Returns:

list of package providers

lookupPackageProvider

public static PackageProvider lookupPackageProvider(java.lang.String name)

Looup a package provider by name

Parameters:

name - the name

Returns:

the package provider

deletePackageKey

public static void deletePackageKey(PackageKey key)

Deletes a package key

Parameters:

key - the key to delete

lookupPackageKey

public static PackageKey lookupPackageKey(java.lang.String key)

Lookup a package key object

Parameters:

key - the key to lookup

Returns:

the package key

listPackageKeys

public static java.util.List<PackageKey> listPackageKeys()

List all package keys

Returns:

list of package key objects

getPackagesChannelArchCompatAndOrgAccess

public static DataResult getPackagesChannelArchCompatAndOrgAccess(java.lang.Long orgId,
                                                                  java.lang.Long channelId,
                                                                  java.util.List<java.lang.Long> packageIds)

Returns information, whether each package in the list is channel compatible and whether the org has accesds to

Parameters:

orgId - organization id

channelId - channel id

packageIds - list of package ids

Returns:

dataresult(id, package_arch_id, org_package, org_access, shared_access)

getErrataChannelIntersection

public static java.util.List<java.util.Map<java.lang.String,java.lang.String>> getErrataChannelIntersection(java.lang.Long cid,
                                                                                                            java.lang.Long eid,
                                                                                                            boolean published)

Returns package names that are shared between an erratum and a channel, with string representations of the versions in each.

Parameters:

cid - channel id

eid - errata id

published - whether the erratum is published or not

Returns:

list of maps, with keys of "name", "channel_version", and "errata_version"