Skip navigation links

oracle.irm.engine.core.device
Class NetworkAdapterCollectionFactory

java.lang.Object
oracle.irm.engine.core.device.NetworkAdapterCollectionFactory

public final class NetworkAdapterCollectionFactory

extends Object

Network Adapter collection factory and utilities. This class provides methods for creating new instances of NetworkAdapter collections as well as providing a number of collection based utility methods and fields. These methods are provided mainly for convenience and to provide a consistent way to create Network Adapter collections. Methods that take collection parameters make no assumptions about what collection implementation is used, so the use of these factory style methods is at the developers discretion.

Field Summary

static Collection<NetworkAdapter>

EMPTY_NETWORK_ADAPTERS An empty Network Adapter collection.

Method Summary

static Collection<NetworkAdapter>	copyNetworkAdapters(Collection<NetworkAdapter> collection) Create a shallow copy of a Network Adapter collection.
static Collection<NetworkAdapter>	createNetworkAdapters(int capacity) Create an empty Network Adapter collection with a capacity specified.
static Collection<NetworkAdapter>	createNetworkAdapters(NetworkAdapter... elements) Create a Network Adapter collection containing zero or more elements.
static Collection<NetworkAdapter>	unmodifiableNetworkAdapters(Collection<NetworkAdapter> value) Create an immutable shallow copy of a Network Adapter collection.

Methods inherited from class java.lang.Object

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

Field Detail

EMPTY_NETWORK_ADAPTERS

public static final Collection<NetworkAdapter> EMPTY_NETWORK_ADAPTERS

An empty Network Adapter collection. This empty collection is immutable. This field is useful if a method requires a collection argument but the caller wants to supply an empty collection. Using this field value rather than passing null can aid code clarity.

Method Detail

createNetworkAdapters

public static Collection<NetworkAdapter> createNetworkAdapters(NetworkAdapter... elements)

Create a Network Adapter collection containing zero or more elements. Creates a collection and adds all of the provided elements into the specified collection. This method is provided as a convenience method as it allows creation of an empty collection, a collection with one element or a collection with many elements (all in one line of code).

Parameters:

elements - The elements to add into the collection.

Returns:

The collection containing the specified elements. If no elements are provided an empty collection is returned.

createNetworkAdapters

public static Collection<NetworkAdapter> createNetworkAdapters(int capacity)

Create an empty Network Adapter collection with a capacity specified. Creates an empty collection with an initial capacity for n elements.

Parameters:

capacity - The initial collection capacity.

Returns:

The empty collection with the specified capacity.

copyNetworkAdapters

public static Collection<NetworkAdapter> copyNetworkAdapters(Collection<NetworkAdapter> collection)

Create a shallow copy of a Network Adapter collection. A shallow copy creates a new collection which contains the elements of the provided collection.

Parameters:

collection - The collection to copy.

Returns:

The copy of the collection. If the provided collection is null, an empty collection is returned.

unmodifiableNetworkAdapters

public static Collection<NetworkAdapter> unmodifiableNetworkAdapters(Collection<NetworkAdapter> value)

Create an immutable shallow copy of a Network Adapter collection. Network Adapter objects are immutable (cannot be changed once created). An immutable collection of Network Adapter elements can therefore be treated as immutable (neither the collection or elements can be changed once created).

Parameters:

value - The collection to copy.

Returns:

The immutable collection. If the provided collection is null, an empty collection is returned.

Skip navigation links