Modifier and Type	Class and Description
public static enum	ImageLocation.LocationType

Field Summary

Modifier and Type	Field and Description
public static final int	ATTRIBUTE_BASE String table offset of resource path base.
public static final int	ATTRIBUTE_COMPRESSED In-image byte size of the compressed resource.
public static final int	ATTRIBUTE_COUNT Number of attribute kinds.
public static final int	ATTRIBUTE_END End of attribute stream marker.
public static final int	ATTRIBUTE_EXTENSION String table offset of resource path extension.
public static final int	ATTRIBUTE_MODULE String table offset of module name.
public static final int	ATTRIBUTE_OFFSET Container byte offset of resource.
public static final int	ATTRIBUTE_PARENT String table offset of resource path parent.
public static final int	ATTRIBUTE_PREVIEW_FLAGS Flags relating to preview mode resources.
public static final int	ATTRIBUTE_UNCOMPRESSED In-memory byte size of the uncompressed resource.
protected final long[]	attributes
private static final int	FLAGS_HAS_PREVIEW_VERSION Indicates that a non-preview location is associated with preview resources.
private static final int	FLAGS_IS_PREVIEW_ONLY Indicates that a location only exists due to preview resources.
private static final int	FLAGS_IS_PREVIEW_VERSION Set on all locations in the `/modules/xxx/META-INF/preview/...`
pack-priv static final String	MODULES_PREFIX
pack-priv static final String	PACKAGES_PREFIX
pack-priv static final String	PREVIEW_INFIX
protected final ImageStrings	strings

Constructor Summary

Access	Constructor and Description
public	ImageLocation(long[] attributes, ImageStrings strings)

Method Summary

Modifier and Type	Method and Description
public static byte[]	compress(long[] attributes)
pack-priv static long[]	decompress(ByteBuffer bytes, int offset)
pack-priv long	getAttribute(int kind)
pack-priv String	getAttributeString(int kind)
public String	getBase()
public int	getBaseOffset()
public long	getCompressedSize()
public long	getContentOffset()
public String	getExtension()
public int	getExtensionOffset()
public int	getFlags()
public String	getFullName()
public String	getFullName(boolean modulesPrefix)
public String	getModule()
public int	getModuleOffset()
public static int	Returns: package flags for `"/packages/xxx"` directory entries. getPackageFlags(List<ModuleLink> moduleLinks) Helper function to calculate package flags for `"/packages/xxx"` directory entries.
public String	getParent()
public int	getParentOffset()
public static int	Returns: flags for the ATTRIBUTE_PREVIEW_FLAGS attribute. getPreviewFlags(String the jimage name of the resource or directory. name, Predicate<String> a predicate for jimage names returning whether an entry is present. hasEntry) Helper function to calculate preview flags (ATTRIBUTE_PREVIEW_FLAGS).
pack-priv ImageStrings	getStrings()
public ImageLocation.LocationType	getType()
public long	getUncompressedSize()
public static boolean	hasPreviewVersion(int flags) Tests a non-preview image location's flags to see if it has preview content associated with it.
public static boolean	isPreviewOnly(int flags) Tests an image location's flags to see if it only exists in preview mode.
private boolean	isRootDir()
pack-priv static ImageLocation	readFrom(BasicImageReader reader, int offset)
private static long	readValue(int length, ByteBuffer buffer, int offset, int limit)
public String	toString() Overrides java.lang.Object.toString. Returns a string representation of the object.
public boolean	verify(String name)
pack-priv static boolean	verify(String name, long[] attributes, ImageStrings strings) A simpler verification would be `name.equals(getFullName())`, but by not creating the full name and enabling early returns we allocate fewer objects.
pack-priv static boolean	verify(String module, String name, ByteBuffer locations, int locationOffset, ImageStrings strings)
pack-priv static boolean	verify(String module, String name, long[] attributes, ImageStrings strings)
private static boolean	verifyName(String module, String name, int index, int length, int moduleOffset, int parentOffset, int baseOffset, int extOffset, ImageStrings strings)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll wait wait wait

Field Detail

ATTRIBUTE_BASE	back to summary
public static final int ATTRIBUTE_BASE String table offset of resource path base.

ATTRIBUTE_COMPRESSED	back to summary
public static final int ATTRIBUTE_COMPRESSED In-image byte size of the compressed resource.

ATTRIBUTE_COUNT	back to summary
public static final int ATTRIBUTE_COUNT Number of attribute kinds.

ATTRIBUTE_END	back to summary
public static final int ATTRIBUTE_END End of attribute stream marker.

ATTRIBUTE_EXTENSION	back to summary
public static final int ATTRIBUTE_EXTENSION String table offset of resource path extension.

ATTRIBUTE_MODULE	back to summary
public static final int ATTRIBUTE_MODULE String table offset of module name.

ATTRIBUTE_OFFSET	back to summary
public static final int ATTRIBUTE_OFFSET Container byte offset of resource.

ATTRIBUTE_PARENT	back to summary
public static final int ATTRIBUTE_PARENT String table offset of resource path parent.

ATTRIBUTE_PREVIEW_FLAGS	back to summary
public static final int ATTRIBUTE_PREVIEW_FLAGS Flags relating to preview mode resources.

ATTRIBUTE_UNCOMPRESSED	back to summary
public static final int ATTRIBUTE_UNCOMPRESSED In-memory byte size of the uncompressed resource.

attributes	back to summary
protected final long[] attributes

FLAGS_HAS_PREVIEW_VERSION back to summary

FLAGS_HAS_PREVIEW_VERSION	back to summary
private static final int FLAGS_HAS_PREVIEW_VERSION Indicates that a non-preview location is associated with preview resources. This can apply to both resources and directories in the `/modules/xxx/...` namespace, as well as `/packages/xxx` directories. For `/packages/xxx` directories, it indicates that the package has preview resources in one of the modules in which it exists.

private static final int FLAGS_HAS_PREVIEW_VERSION

Indicates that a non-preview location is associated with preview resources.

This can apply to both resources and directories in the /modules/xxx/... namespace, as well as /packages/xxx directories.

For /packages/xxx directories, it indicates that the package has preview resources in one of the modules in which it exists.

FLAGS_IS_PREVIEW_ONLY back to summary

FLAGS_IS_PREVIEW_ONLY	back to summary
private static final int FLAGS_IS_PREVIEW_ONLY Indicates that a location only exists due to preview resources. This can apply to both resources and directories in the `/modules/xxx/...` namespace, as well as `/packages/xxx` directories. For `/packages/xxx` directories it indicates that, for every module in which the package exists, it is preview only. This flag is mutually exclusive with `FLAGS_HAS_PREVIEW_VERSION` and need not imply that `FLAGS_IS_PREVIEW_VERSION` is set (i.e. for `/packages/xxx` directories).

private static final int FLAGS_IS_PREVIEW_ONLY

Indicates that a location only exists due to preview resources.

This can apply to both resources and directories in the /modules/xxx/... namespace, as well as /packages/xxx directories.

For /packages/xxx directories it indicates that, for every module in which the package exists, it is preview only.

This flag is mutually exclusive with FLAGS_HAS_PREVIEW_VERSION and need not imply that FLAGS_IS_PREVIEW_VERSION is set (i.e. for /packages/xxx directories).

FLAGS_IS_PREVIEW_VERSION back to summary

FLAGS_IS_PREVIEW_VERSION	back to summary
private static final int FLAGS_IS_PREVIEW_VERSION Set on all locations in the `/modules/xxx/META-INF/preview/...` namespace. This flag is mutually exclusive with `FLAGS_HAS_PREVIEW_VERSION`.

private static final int FLAGS_IS_PREVIEW_VERSION

Set on all locations in the /modules/xxx/META-INF/preview/... namespace.

This flag is mutually exclusive with FLAGS_HAS_PREVIEW_VERSION.

MODULES_PREFIX	back to summary
pack-priv static final String MODULES_PREFIX

PACKAGES_PREFIX	back to summary
pack-priv static final String PACKAGES_PREFIX

PREVIEW_INFIX	back to summary
pack-priv static final String PREVIEW_INFIX

strings	back to summary
protected final ImageStrings strings

Constructor Detail

ImageLocation	back to summary
public ImageLocation(long[] attributes, ImageStrings strings)

Method Detail

compress	back to summary
public static byte[] compress(long[] attributes)

decompress	back to summary
pack-priv static long[] decompress(ByteBuffer bytes, int offset)

getAttribute	back to summary
pack-priv long getAttribute(int kind)

getAttributeString	back to summary
pack-priv String getAttributeString(int kind)

getBase	back to summary
public String getBase()

getBaseOffset	back to summary
public int getBaseOffset()

getCompressedSize	back to summary
public long getCompressedSize()

getContentOffset	back to summary
public long getContentOffset()

getExtension	back to summary
public String getExtension()

getExtensionOffset	back to summary
public int getExtensionOffset()

getFlags	back to summary
public int getFlags()

getFullName	back to summary
public String getFullName()

getFullName	back to summary
public String getFullName(boolean modulesPrefix)

getModule	back to summary
public String getModule()

getModuleOffset	back to summary
public int getModuleOffset()

getPackageFlags back to summary

getPackageFlags	back to summary
public static int getPackageFlags(List<ModuleLink> moduleLinks) Helper function to calculate package flags for `"/packages/xxx"` directory entries. Based on the module links, the flags are: `FLAGS_HAS_PREVIEW_VERSION` if any referenced package has a preview version. `FLAGS_IS_PREVIEW_ONLY` if all referenced packages are preview only. Returns:int package flags for `"/packages/xxx"` directory entries.

public static int getPackageFlags(List<ModuleLink> moduleLinks)

Helper function to calculate package flags for "/packages/xxx" directory entries.

Based on the module links, the flags are:

FLAGS_HAS_PREVIEW_VERSION if any referenced package has a preview version.
FLAGS_IS_PREVIEW_ONLY if all referenced packages are preview only.

Returns:int: package flags for "/packages/xxx" directory entries.

getParent	back to summary
public String getParent()

getParentOffset	back to summary
public int getParentOffset()

getPreviewFlags back to summary

getPreviewFlags	back to summary
public static int getPreviewFlags(String name, Predicate<String> hasEntry) Helper function to calculate preview flags (ATTRIBUTE_PREVIEW_FLAGS). Since preview flags are calculated separately for resource nodes and directory nodes (in two quite different places) it's useful to have a common helper. Based on the entry name, the flags are: `"[/modules]/<module>/<path>"` normal resource or directory: Zero, or `FLAGS_HAS_PREVIEW_VERSION` if a preview entry exists. `"[/modules]/<module>/META-INF/preview/<path>"` preview resource or directory: `FLAGS_IS_PREVIEW_VERSION`, and additionally `FLAGS_IS_PREVIEW_ONLY` if no normal version of the resource or directory exists. In all other cases, returned flags are zero (note that `"/packages/xxx"` entries may have flags, but these are calculated elsewhere). Parameters name:String the jimage name of the resource or directory. hasEntry:Predicate<String> a predicate for jimage names returning whether an entry is present. Returns:int flags for the ATTRIBUTE_PREVIEW_FLAGS attribute.

public static int getPreviewFlags(String name, Predicate<String> hasEntry)

Helper function to calculate preview flags (ATTRIBUTE_PREVIEW_FLAGS).

Since preview flags are calculated separately for resource nodes and directory nodes (in two quite different places) it's useful to have a common helper.

Based on the entry name, the flags are:

"[/modules]/<module>/<path>" normal resource or directory:
Zero, or FLAGS_HAS_PREVIEW_VERSION if a preview entry exists.
"[/modules]/<module>/META-INF/preview/<path>" preview resource or directory:
FLAGS_IS_PREVIEW_VERSION, and additionally FLAGS_IS_PREVIEW_ONLY if no normal version of the resource or directory exists.
In all other cases, returned flags are zero (note that "/packages/xxx" entries may have flags, but these are calculated elsewhere).

Parameters

name:String: the jimage name of the resource or directory.
hasEntry:Predicate<String>: a predicate for jimage names returning whether an entry is present.

Returns:int

flags for the ATTRIBUTE_PREVIEW_FLAGS attribute.

getStrings	back to summary
pack-priv ImageStrings getStrings()

getType	back to summary
public ImageLocation.LocationType getType()

getUncompressedSize	back to summary
public long getUncompressedSize()

hasPreviewVersion	back to summary
public static boolean hasPreviewVersion(int flags) Tests a non-preview image location's flags to see if it has preview content associated with it.

isPreviewOnly	back to summary
public static boolean isPreviewOnly(int flags) Tests an image location's flags to see if it only exists in preview mode.

isRootDir	back to summary
private boolean isRootDir()

readFrom	back to summary
pack-priv static ImageLocation readFrom(BasicImageReader reader, int offset)

readValue	back to summary
private static long readValue(int length, ByteBuffer buffer, int offset, int limit)

toString back to summary

public String toString()

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object. Satisfying this method's contract implies a non-null result must be returned.

Annotations

@Override

verify	back to summary
public boolean verify(String name)

verify	back to summary
pack-priv static boolean verify(String name, long[] attributes, ImageStrings strings) A simpler verification would be `name.equals(getFullName())`, but by not creating the full name and enabling early returns we allocate fewer objects.

verify	back to summary
pack-priv static boolean verify(String module, String name, ByteBuffer locations, int locationOffset, ImageStrings strings)

verify	back to summary
pack-priv static boolean verify(String module, String name, long[] attributes, ImageStrings strings)

verifyName	back to summary
private static boolean verifyName(String module, String name, int index, int length, int moduleOffset, int parentOffset, int baseOffset, int extOffset, ImageStrings strings)

jdk.internal.jimage back to summary

public final Enum ImageLocation.LocationType

Class Inheritance

extends Enum<ImageLocation.LocationType>

java.lang.Object
java.lang.Enum
jdk.internal.jimage.ImageLocation.LocationType

Field Summary

Modifier and Type	Field and Description
public static final ImageLocation.LocationType	MODULES_DIR
public static final ImageLocation.LocationType	MODULES_ROOT
public static final ImageLocation.LocationType	PACKAGES_DIR
public static final ImageLocation.LocationType	PACKAGES_ROOT
public static final ImageLocation.LocationType	RESOURCE

Constructor Summary

Access	Constructor and Description
private	LocationType()

Method Summary

Modifier and Type	Method and Description
public static ImageLocation.LocationType	valueOf(String name)
public static ImageLocation.LocationType[]	values()

Inherited from java.lang.Enum:: clone compareTo describeConstable equals finalize getDeclaringClass hashCode name ordinal toString valueOf

Field Detail

MODULES_DIR	back to summary
public static final ImageLocation.LocationType MODULES_DIR

MODULES_ROOT	back to summary
public static final ImageLocation.LocationType MODULES_ROOT

PACKAGES_DIR	back to summary
public static final ImageLocation.LocationType PACKAGES_DIR

PACKAGES_ROOT	back to summary
public static final ImageLocation.LocationType PACKAGES_ROOT

RESOURCE	back to summary
public static final ImageLocation.LocationType RESOURCE

Constructor Detail

LocationType	back to summary
private LocationType()

Method Detail

valueOf	back to summary
public static ImageLocation.LocationType valueOf(String name)

values	back to summary
public static ImageLocation.LocationType[] values()

public Class ImageLocation

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public final Enum ImageLocation.LocationType

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail