Class WovenClassImpl

java.lang.Object

org.apache.felix.framework.WovenClassImpl

All Implemented Interfaces:

Iterable<String>, Collection<String>, List<String>, WovenClass

class WovenClassImpl
extends Object
implements WovenClass, List<String>

Field Summary

Fields

Modifier and Type	Field	Description
private byte[]	m_bytes
private final String	m_className
private Class	m_definedClass
private List<String>	m_imports
private boolean	m_isComplete
private int	m_state
private final BundleWiring	m_wiring

Fields inherited from interface WovenClass

DEFINE_FAILED, DEFINED, TRANSFORMED, TRANSFORMING, TRANSFORMING_FAILED

Constructor Summary

Constructors

Constructor	Description
WovenClassImpl(String className, BundleWiring wiring, byte[] bytes)

Method Summary

Modifier and Type	Method	Description
(package private) byte[]	_getBytes()
void	add(int i, String s)
boolean	add(String s)
boolean	addAll(int i, Collection<? extends String> collection)
boolean	addAll(Collection<? extends String> collection)
private void	checkImport(String s)
void	clear()
(package private) void	complete(Class definedClass, byte[] bytes, List<String> imports)
(package private) void	completeDefine(Class definedClass)
(package private) void	completeImports(List<String> imports)
boolean	contains(Object o)
boolean	containsAll(Collection<?> collection)
String	get(int i)
BundleWiring	getBundleWiring()	Returns the bundle wiring whose class loader will define the woven class.
byte[]	getBytes()	Returns the class file bytes to be used to define the named class.
String	getClassName()	Returns the fully qualified name of the class being woven.
Class<?>	getDefinedClass()	Returns the class defined by this woven class.
List<String>	getDynamicImports()	Returns the list of dynamic import package descriptions to add to the bundle wiring for this woven class.
(package private) List<String>	getDynamicImportsInternal()
ProtectionDomain	getProtectionDomain()	Returns the protection domain to which the woven class will be assigned when it is defined.
int	getState()	Returns the current state of this woven class.
int	indexOf(Object o)
boolean	isEmpty()
boolean	isWeavingComplete()	Returns whether weaving is complete in this woven class.
Iterator<String>	iterator()
int	lastIndexOf(Object o)
ListIterator<String>	listIterator()
ListIterator<String>	listIterator(int i)
String	remove(int i)
boolean	remove(Object o)
boolean	removeAll(Collection<?> collection)
boolean	retainAll(Collection<?> collection)
String	set(int i, String s)
void	setBytes(byte[] bytes)	Set the class file bytes to be used to define the named class.
void	setState(int state)
int	size()
List<String>	subList(int i, int i1)
Object[]	toArray()
<T> T[]	toArray(T[] ts)

Methods inherited from class Object

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

Methods inherited from interface Collection

parallelStream, removeIf, stream

Methods inherited from interface Iterable

forEach

Methods inherited from interface List

equals, hashCode, replaceAll, sort, spliterator

Field Details

m_className

private final String m_className

m_wiring

private final BundleWiring m_wiring

m_bytes

private byte[] m_bytes

m_imports

private List<String> m_imports

m_definedClass

private Class m_definedClass

m_isComplete

private boolean m_isComplete

m_state

private int m_state

Constructor Details

WovenClassImpl

WovenClassImpl(String className,
 BundleWiring wiring,
 byte[] bytes)

Method Details

complete

void complete(Class definedClass,
 byte[] bytes,
 List<String> imports)

completeImports

void completeImports(List<String> imports)

completeDefine

void completeDefine(Class definedClass)

getBytes

public byte[] getBytes()

Description copied from interface: WovenClass

Returns the class file bytes to be used to define the named class.

While in the WovenClass.TRANSFORMING state, this method returns a reference to the class files byte array contained in this object. After leaving the WovenClass.TRANSFORMING state, this woven class can no longer be transformed and a copy of the class file byte array is returned.

Specified by:

getBytes in interface WovenClass

Returns:

The bytes to be used to define the named class.

setBytes

public void setBytes(byte[] bytes)

Description copied from interface: WovenClass

Set the class file bytes to be used to define the named class. This method must not be called outside invocations of the weave method by the framework.

While in the WovenClass.TRANSFORMING state, this method replaces the reference to the array contained in this object with the specified array. After leaving the WovenClass.TRANSFORMING state, this woven class can no longer be transformed and this method will throw an IllegalStateException.

Specified by:

setBytes in interface WovenClass

Parameters:

bytes - The new classfile that will be used to define the named class. The specified array is retained by this object and the caller must not modify the specified array.

getDynamicImportsInternal

List<String> getDynamicImportsInternal()

getDynamicImports

public List<String> getDynamicImports()

Description copied from interface: WovenClass

Returns the list of dynamic import package descriptions to add to the bundle wiring for this woven class. Changes made to the returned list will be visible to later weaving hooks called with this object. The returned list must not be modified outside invocations of the weave method by the framework.

After leaving the WovenClass.TRANSFORMING state, this woven class can no longer be transformed and the returned list will be unmodifiable.

If the Java runtime environment supports permissions, any modification to the returned list requires AdminPermission[bundle,WEAVE]. Additionally, any add or set modification requires PackagePermission[package,IMPORT].

Specified by:

getDynamicImports in interface WovenClass

Returns:

A list containing zero or more dynamic import package descriptions to add to the bundle wiring for this woven class. This list must throw IllegalArgumentException if a malformed dynamic import package description is added.

See Also:

• "Core Specification, Dynamic Import Package, for the syntax of a dynamic import package description."

isWeavingComplete

public boolean isWeavingComplete()

Description copied from interface: WovenClass

Returns whether weaving is complete in this woven class. Weaving is complete after the class is defined.

Specified by:

isWeavingComplete in interface WovenClass

Returns:

true if state is WovenClass.DEFINED, WovenClass.TRANSFORMING_FAILED or WovenClass.DEFINE_FAILED; false otherwise.

getClassName

public String getClassName()

Description copied from interface: WovenClass

Returns the fully qualified name of the class being woven.

Specified by:

getClassName in interface WovenClass

Returns:

The fully qualified name of the class being woven.

getProtectionDomain

public ProtectionDomain getProtectionDomain()

Description copied from interface: WovenClass

Returns the protection domain to which the woven class will be assigned when it is defined.

Specified by:

getProtectionDomain in interface WovenClass

Returns:

The protection domain to which the woven class will be assigned when it is defined, or null if no protection domain will be assigned.

getDefinedClass

public Class<?> getDefinedClass()

Description copied from interface: WovenClass

Returns the class defined by this woven class. During weaving, this method will return null. Once weaving is complete, this method will return the class object if this woven class was used to define the class.

Specified by:

getDefinedClass in interface WovenClass

Returns:

The class associated with this woven class, or null if weaving is not complete, the class definition failed or this woven class was not used to define the class.

getBundleWiring

public BundleWiring getBundleWiring()

Description copied from interface: WovenClass

Returns the bundle wiring whose class loader will define the woven class.

Specified by:

getBundleWiring in interface WovenClass

Returns:

The bundle wiring whose class loader will define the woven class.

size

public int size()

Specified by:

size in interface Collection<String>

Specified by:

size in interface List<String>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Collection<String>

Specified by:

isEmpty in interface List<String>

contains

public boolean contains(Object o)

Specified by:

contains in interface Collection<String>

Specified by:

contains in interface List<String>

iterator

public Iterator<String> iterator()

Specified by:

iterator in interface Collection<String>

Specified by:

iterator in interface Iterable<String>

Specified by:

iterator in interface List<String>

toArray

public Object[] toArray()

Specified by:

toArray in interface Collection<String>

Specified by:

toArray in interface List<String>

toArray

public <T> T[] toArray(T[] ts)

Specified by:

toArray in interface Collection<String>

Specified by:

toArray in interface List<String>

add

public boolean add(String s)

Specified by:

add in interface Collection<String>

Specified by:

add in interface List<String>

checkImport

private void checkImport(String s)

remove

public boolean remove(Object o)

Specified by:

remove in interface Collection<String>

Specified by:

remove in interface List<String>

containsAll

public boolean containsAll(Collection<?> collection)

Specified by:

containsAll in interface Collection<String>

Specified by:

containsAll in interface List<String>

addAll

public boolean addAll(Collection<? extends String> collection)

Specified by:

addAll in interface Collection<String>

Specified by:

addAll in interface List<String>

addAll

public boolean addAll(int i,
 Collection<? extends String> collection)

Specified by:

addAll in interface List<String>

removeAll

public boolean removeAll(Collection<?> collection)

Specified by:

removeAll in interface Collection<String>

Specified by:

removeAll in interface List<String>

retainAll

public boolean retainAll(Collection<?> collection)

Specified by:

retainAll in interface Collection<String>

Specified by:

retainAll in interface List<String>

clear

public void clear()

Specified by:

clear in interface Collection<String>

Specified by:

clear in interface List<String>

get

public String get(int i)

Specified by:

get in interface List<String>

set

public String set(int i,
 String s)

Specified by:

set in interface List<String>

add

public void add(int i,
 String s)

Specified by:

add in interface List<String>

remove

public String remove(int i)

Specified by:

remove in interface List<String>

indexOf

public int indexOf(Object o)

Specified by:

indexOf in interface List<String>

lastIndexOf

public int lastIndexOf(Object o)

Specified by:

lastIndexOf in interface List<String>

listIterator

public ListIterator<String> listIterator()

Specified by:

listIterator in interface List<String>

listIterator

public ListIterator<String> listIterator(int i)

Specified by:

listIterator in interface List<String>

subList

public List<String> subList(int i,
 int i1)

Specified by:

subList in interface List<String>

_getBytes

byte[] _getBytes()

getState

public int getState()

Description copied from interface: WovenClass

Returns the current state of this woven class.

A woven class can be in only one state at any time.

Specified by:

getState in interface WovenClass

Returns:

Either WovenClass.TRANSFORMING, WovenClass.TRANSFORMED, WovenClass.DEFINED, WovenClass.TRANSFORMING_FAILED or WovenClass.DEFINE_FAILED.

setState

public void setState(int state)