Module openj9.dtfj

Package com.ibm.dtfj.javacore.builder.javacore

Class ImageAddressSpaceBuilder

java.lang.Object

com.ibm.dtfj.javacore.builder.javacore.AbstractBuilderComponent

com.ibm.dtfj.javacore.builder.javacore.ImageAddressSpaceBuilder

All Implemented Interfaces:

IImageAddressSpaceBuilder

public class ImageAddressSpaceBuilder
extends AbstractBuilderComponent
implements IImageAddressSpaceBuilder

See Also:

• IImageAddressSpaceBuilder
• com.ibm.dtfj.javacore.builder.AbstractBuilderComponent

Constructor Summary

Constructors

Constructor	Description
ImageAddressSpaceBuilder(JCImage image, String id)

Method Summary

Modifier and Type	Method	Description
ImageSection	addImageSection(String name, long base, long size)	Create a new image section with the given name, base address and size and add it to the list in the ImageAddressSpace.
IImageProcessBuilder	generateImageProcessBuilder(String id)	To associate a new image process to the image address space being built by this image address space factory, use this interface to create a new image process factory for the aforementioned image process.
IImageProcessBuilder	getCurrentImageProcessBuilder()	Returns the current image process builder (factory) associated with the image address space factory.
IImageProcessBuilder	getImageProcessBuilder(String builderID)	In multiple image process scenarios, each image process is associated with it's own image process factory, and the latter are distinguished by unique id values.

Methods declared in class com.ibm.dtfj.javacore.builder.javacore.AbstractBuilderComponent

getBuilderContainer, getID

Methods declared in class java.lang.Object

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

Constructor Details

ImageAddressSpaceBuilder

public ImageAddressSpaceBuilder(JCImage image,
 String id)
                         throws JCInvalidArgumentsException

Parameters:

image - valid com.ibm.dtfj.javacore.image.JCImage associated with this image address factory. Must not be null.

id - unique id for this factory. Must not be null.

Throws:

JCInvalidArgumentsException - if image is null

Method Details

getCurrentImageProcessBuilder

public IImageProcessBuilder getCurrentImageProcessBuilder()

Description copied from interface: IImageAddressSpaceBuilder

Returns the current image process builder (factory) associated with the image address space factory. Usually, there is only one image process, thus one image process factory. In the event that multiple image processes exist for one image address space, the current image process factory may be the last image process factory generated by the image address space factory.

Specified by:

getCurrentImageProcessBuilder in interface IImageAddressSpaceBuilder

Returns:

current image process builder. Must not be null.

See Also:

• IImageAddressSpaceBuilder.getCurrentImageProcessBuilder()

generateImageProcessBuilder

public IImageProcessBuilder generateImageProcessBuilder(String id)
                                                 throws BuilderFailureException

Description copied from interface: IImageAddressSpaceBuilder

To associate a new image process to the image address space being built by this image address space factory, use this interface to create a new image process factory for the aforementioned image process. At least one image process must exist for an image address space, therefore consequently, at least one image process factory must be created for each image address space factory.

Specified by:

generateImageProcessBuilder in interface IImageAddressSpaceBuilder

Parameters:

id - unique id for the new image address space factory

Returns:

generated image process factory. must not be null.

Throws:

BuilderFailureException - if image process factory not generated.

See Also:

• IImageAddressSpaceBuilder.generateImageProcessBuilder(String)

getImageProcessBuilder

public IImageProcessBuilder getImageProcessBuilder(String builderID)

Description copied from interface: IImageAddressSpaceBuilder

In multiple image process scenarios, each image process is associated with it's own image process factory, and the latter are distinguished by unique id values.

Specified by:

getImageProcessBuilder in interface IImageAddressSpaceBuilder

Parameters:

builderID - unique id of the image process factory

Returns:

found image process factory, or null if not found

See Also:

• IImageAddressSpaceBuilder.getImageProcessBuilder(String)

addImageSection

public ImageSection addImageSection(String name,
 long base,
 long size)

Description copied from interface: IImageAddressSpaceBuilder

Create a new image section with the given name, base address and size and add it to the list in the ImageAddressSpace.

Specified by:

addImageSection in interface IImageAddressSpaceBuilder