I\'m new to Java (have experience with C#),
this is what I want to do:
public final class MyClass
{
public class MyRelatedClass
{
...
}
In response to the comments about packaging multiple classes in one file: unlike .NET, most implementations of java enforce a strict correlation between the name of public class type and the name of the file the class type is declared in. It's not a hard requirement, but not used a system where the correlation is not enforced. The JLS - 7.6 Top Level Type Declarations says this:
When packages are stored in a file system (§7.2.1), the host system may choose to enforce the restriction that it is a compile-time error if a type is not found in a file under a name composed of the type name plus an extension (such as .java or .jav) if either of the following is true:
- The type is referred to by code in other compilation units of the package in which the type is declared.
- The type is declared public (and therefore is potentially accessible from code in other packages).
See this SO question: multiple class declarations in one file
If you are looking to create a namespace to enclose your related classes, then using static inner classes are what you need. The static declaration does not mean one instnace - they can still be instantiated - the static
means that they can be instantiated without needing a reference to the enclosing class. As the enclosing class is just for grouping, and not data, you are safe making it a static. To make it clearer that the enclosing class is just for grouping, you should declare it as an interface
, so that it cannot be instantiated and has no implementation details.
Although personally, I would refrain from doing this - in Java, packages are used to enforce a namespace. Using inner classes for this quickly becomes cumbersome. (I have tried it!)
The way you've defined MyRelatedClass
, you need to have an instance of MyClass
to be able to access/instantiate this class.
Typically in Java you use this pattern when an instance of MyRelatedClass
needs to access some fields of a MyClass
instance (hence the references to an "enclosing instance" in the compiler warning).
Something like this should compile:
public void doStuff() {
MyClass mc = new MyClass();
MyRelatedClass data = mc.new MyRelatedClass();
}
However, if a MyRelatedClass
instance does not need access to fields of it's enclosing instance (MyClass
's fields) then you should consider defining MyRelatedClass
as a static class, this will allow the original code you've posted to compile.
The difference in having a nested class (what you've posted) and a static nested class (a static class
within a class
) is that in the former, the nested class belongs to an instance of the parent class, while the latter has no such relationship - only a logical/namespace relationship.
Yes, non static nested classes have access to the outer classes instance members, and therefore must be created for an instance of the outer class. So you have two choices:
In practice, I rarely create an instance of the inner class, except in methods of the outer class, and I rarely make such classes mutable -- but this is just me.
Try defining MyRelatedClass
as static.
edit
More on the subject
http://java.sun.com/docs/books/tutorial/java/javaOO/nested.html