com.ibm.portal.devicesupport
Interface DeviceClassLocator<E extends DeviceClass>

All Superinterfaces:

Locator<E>

public interface DeviceClassLocator<E extends DeviceClass>
extends Locator<E>

A locator for device classes. Provides access to device classes based on their name.

Since:

7.0.0.2

Method Summary

E	findByName(java.lang.String name) Find a device class by administrative name
java.util.List<E>	findByNames(java.util.List<java.lang.String> names) Finds device classes by administrative name
java.util.List<E>	findByNamesWithoutNulls(java.util.List<java.lang.String> names) Finds device classes by administrative name, but returns a list with no null entries.

Methods inherited from interface com.ibm.portal.Locator

findByID, findByUniqueName

Method Detail

findByName

E findByName(java.lang.String name)
                                 throws DataException

Find a device class by administrative name

Parameters:

name - name of a device class

Returns:

the device class if one exists with the given name, otherwise null

Throws:

DataException - if an error occurred while accessing the backend

findByNames

java.util.List<E> findByNames(java.util.List<java.lang.String> names)
                                                  throws DataException

Finds device classes by administrative name

Parameters:

name - list of names of a device class, not null

Returns:

the list of device classes. for each position in the list of names, it contains the device class if one exists, otherwise null

Throws:

DataException - if an error occurred while accessing the backend

Since:

8.0.0.1

findByNamesWithoutNulls

java.util.List<E> findByNamesWithoutNulls(java.util.List<java.lang.String> names)
                                                              throws DataException

Finds device classes by administrative name, but returns a list with no null entries.

Parameters:

name - List of names of a device class, not null

Returns:

The list of non-null device classes. This is not positional per name in the input list with nulls for unrecognized device classes, but only the existing entries are returned (no need to remove the nulls).

Throws:

DataException - if an error occurred while accessing the backend

Since:

8.5 CF07