Nester - Revision history

Space Walker: add chapter on features

2025-08-12T16:31:33Z

add chapter on features

← Older revision		Revision as of 16:31, 12 August 2025
Line 105:		Line 105:

	The <code>enclosing method name</code> and <code>enclosing method descriptor</code> values are empty for anonymous classes that are declared in in-line initializers for fields.		The <code>enclosing method name</code> and <code>enclosing method descriptor</code> values are empty for anonymous classes that are declared in in-line initializers for fields.

			== Nester ==

			Nester patches inner class attributes in a jar using a [[Nests]] data file. It has the following features:

			* Adding inner class attributes to existing classes.
			* Remapping inner classes to fit the convention for [[Nester#Inner Class Names\|inner class names]].
			* Generating new classes if outer classes specified in the Nests file do not exist.

Space Walker: add chapter on inner class names

2025-08-12T15:48:26Z

add chapter on inner class names

← Older revision		Revision as of 15:48, 12 August 2025
Line 64:		Line 64:
	* Switch statements are compiled to classes with enum value tables.		* Switch statements are compiled to classes with enum value tables.
	* A completely empty class may be generated and passed between multiple nested classes and their outer class to enforce the contract for access between them.		* A completely empty class may be generated and passed between multiple nested classes and their outer class to enforce the contract for access between them.

			=== Inner Class Names ===

			While the JVM specification does not enforce any naming scheme for inner classes, there is a convention for each type of inner class.

			* Names for nested classes are typically composed of the outer class name and the inner name of the nested class. For example, a nested class with outer class name <code>com/example/Outer</code> and inner name <code>Inner</code> typically has the name <code>com/example/Outer$Inner</code>.
			* Names for local classes are typically composed of the outer class name, the inner name of the inner class, and a number that counts up for each local class in the top-level outer class. For example, the second local class in some top-level class, with outer class name <code>com/example/Outer</code> and inner name <code>Inner</code> typically has the name <code>com/example/Outer$2Inner</code>.
			* Names for anonymous classes are typically composed of the outer class name and a number that counts up for each anonymous class in the outer class. For example, the third anonymous class in outer class <code>com/example/Outer</code> typically has the name <code>com/example/Outer$3</code>.

	== Inner Class Attributes ==		== Inner Class Attributes ==

Space Walker: fix two typos

2025-08-12T14:01:26Z

fix two typos

← Older revision		Revision as of 14:01, 12 August 2025
Line 60:		Line 60:
	=== Special Classes ===		=== Special Classes ===

	The Java compiler may generate special classes for some of the language features. These synthetic classes are normally invisible.		The Java compiler may generate special classes for some of the language's features. These synthetic classes are normally invisible.

	* Switch statements are compiled to classes with enum value tables.		* Switch statements are compiled to classes with enum value tables.
	* A completely empty class may be generated and passed between multiple nested ~~class~~ and their outer class to enforce the contract for access between them.		* A completely empty class may be generated and passed between multiple nested classes and their outer class to enforce the contract for access between them.

	== Inner Class Attributes ==		== Inner Class Attributes ==

Space Walker: Created page with "Nester is a tool to patch inner class attributes in Java class files. It takes in a Nests data file and applies those patches to a jar file. == Inner Classes == Inner classes are classes that are defined inside other classes or methods. There are three types of inner classes: nested classes, local classes, and anonymous classes. Each type has its own uses, and a different relationship with its outer class or method. === Nested Classes === A nested class is a cla..."

2025-08-12T13:53:34Z

Created page with "Nester is a tool to patch inner class attributes in Java class files. It takes in a Nests data file and applies those patches to a jar file. == Inner Classes == Inner classes are classes that are defined inside other classes or methods. There are three types of inner classes: nested classes, local classes, and anonymous classes. Each type has its own uses, and a different relationship with its outer class or method. === Nested Classes === A nested class is a cla..."

New page

Nester is a tool to patch inner class attributes in Java class files. It takes in a [[Nests]] data file and applies those patches to a jar file.

== Inner Classes ==

Inner classes are classes that are defined inside other classes or methods. There are three types of inner classes: nested classes, local classes, and anonymous classes. Each type has its own uses, and a different relationship with its outer class or method.

=== Nested Classes ===

A nested class is a class declared inside another class.

<pre>
public class Outer {
...
public class Inner {
...
}
}
</pre>

Nested classes can be ''static'' or ''non-static''.
* A ''static'' nested class can access static members of its outer class, and vice versa, even if those members are private.
* A ''non-static'' nested class can access both static members and instance members of its outer class, and vice versa, even if those members are private.

=== Local Classes ===

A local class a class declared inside a method.

<pre>
public class Outer {
....
public void outer() {
...
class Inner {
...
}
}
}
</pre>

A local class can access both static and instance members from its outer class, as well as local variables from the scope in which it is declared in its outer method.

=== Anonymous Classes ===

An anonymous class is a class declared and instantiated at the same time.

<pre>
public class Outer {
...
public void outer() {
...
Runnable task = new Runnable() {
...
}
}
}
</pre>

An anonymous class can access both static and instance members from its outer class, as well as local variables from the scope in which it is declared in its outer method.

=== Special Classes ===

The Java compiler may generate special classes for some of the language features. These synthetic classes are normally invisible.

* Switch statements are compiled to classes with enum value tables.
* A completely empty class may be generated and passed between multiple nested class and their outer class to enforce the contract for access between them.

== Inner Class Attributes ==

Inner class attributes describe the relationship between inner classes and their outer classes or methods. Obfuscators such as [https://www.guardsquare.com/proguard ProGuard] may remove them to shrink the jar file size. This is generally not a problem, since these attributes do not affect the runtime behavior of a Java application. However, they do make a difference at ''compile time''.

Interactions with inner classes will not work properly if the inner class attributes are missing. Access between non-static nested classes and their outer classes will be broken, anonymous classes will be accessible when they should not be, and references to nested classes will not work.

On top of the compile time issues, decompiler results will be significantly worse for jars where the inner class attributes are not present. Local and anonymous classes will not appear inside their outer classes and methods, and member access between nested classes and their outer classes may appear as references to methods that do not exist.

=== The InnerClasses Attribute ===

The <code>InnerClasses</code> attribute of a class contains entries for all inner classes referenced by that class. Each entry has four values:

* <code>inner class name</code>: the internal name of the inner class
* <code>outer class name</code>: the internal name of the outer class
* <code>inner name</code>: the simple name of the inner class (i.e. the name as declared in the source)
* <code>inner class access</code>: the access modifier flags of the inner class

The <code>outer class name</code> is empty for anonymous and local classes.

The <code>inner name</code> value is empty for anonymous classes.

=== The EnclosingMethod Attribute ===

The <code>EnclosingMethod</code> attribute of a class describes the outer class and method of an inner class. It has three values:

* <code>enclosing class name</code>: the internal name of the enclosing class
* <code>enclosing method name</code>: the name of the enclosing method
* <code>enclosing method descriptor</code>: the type descriptor of the enclosing method

This attribute is only present for local and anonymous classes.

The <code>enclosing method name</code> and <code>enclosing method descriptor</code> values are empty for anonymous classes that are declared in in-line initializers for fields.