Constructor Detail

• TestAllConcepts

  public TestAllConcepts()

  The Constructor of this example. Before calling the constructor (ctor), the memory space is provided and initialized. The initialization of the memory space contains:

  • Initialization of the ObjectJc-base. That base data are disposed at start of memory space always. It the class doesn't have a Object-base (special case of data classes possible, see SimpleDataStruct). than this initialization isn't happen.
  • All other bytes of the whole data spaces are set to 0. Therefore all references are null-references, and all values are default set to 0.

  This memory initialization is done calling a allocation in the Jc-Runtime environment. If the memory is a static one, the user should call init_ObjectJc(object, sizeof(Instance), ident); manually at C-level. Static instances can be defined at C-level before starting initialization in the C-typical wise.
  The constructor starts in C-file with:

   struct TestAllConcepts_Test_t* ctorO_TestAllConcepts_Test(ObjectJc* othis, ThCxt* _thCxt)
   { TestAllConcepts_Test_s* ythis = (TestAllConcepts_Test_s*)othis;  //upcasting to the real class.
     STACKTRC_TENTRY("ctorO_TestAllConcepts_Test");
     checkConsistence_ObjectJc(othis, sizeof(TestAllConcepts_Test_s), null, _thCxt);  
     setReflection_ObjectJc(othis, &reflection_TestAllConcepts_Test_s, sizeof(TestAllConcepts_Test_s));  
   

  • The reference to the instance is given as a ObjectJc*-Reference. This is, because the calling environment supplied only this base reference. This ObjectJc is initialized, especially the size of the memory area is set in ObjectJc.objectIdentSize.
  • The return value is the same reference, but typed to the instance, to set the reference to the initialized instance without casting.
  • ThCxt* _thCxt is the reference of the threadContext. It is necessary for exception handling.
  • The first instruction is the casting to the real type. The casting is unchecked yet, but see next:
  • The STACKTRC_TENTRY(...) registers the method stack level in thread context. It is for exception handling with stack-trace dump.
  • The checkConsistence_ObjectJc(...) tests whether the memory area referenced with ythis is initialized properly. Especially the size of the area is tested. This routine calls an Exception if the conditions are not true. The conditions should be met any time, elsewhere a user software error is happen. After this test the continuation of initialize is safety. Without such test the software may be crash here causing of an external error.
  • setReflection(...) completes the ObjectJc-Data with the only one special information regarding the implementation instance. The reflection include the method table too. It is a structured data defined at C-level in this compilation unit.

  The next action is the call of constructor of the super class. That constructor calls first the constructor of its superclass and so on. The constructor of Object is not called, because the initialization of memory before executing the constructor initializes the ObjectJc-base. There are contained some informations of memory organization.

Method Detail

• access

  public int access(int x)

• returnThisOverrideable_Test

  public TestAllConcepts returnThisOverrideable_Test(int value)

  This method helps to test concatenations with return-this, but override-able. The return value is the same as the calling instance. This is recognized by Java2C, if @ java2c=return-this is written.
  This is also a example for non-using of STACKTRC, it is not necessary here.

  Parameters:

  value - any value

  Returns:

  this

• equals

  public boolean equals(java.lang.Object cmp)

  Check whether Object.equals() will be overridden.

  Overrides:

  equals in class java.lang.Object

  See Also:

  Object.equals(java.lang.Object)

• equals

  public boolean equals(java.lang.String cmp)

  This method doesn't override Object.equals.

• access

  public void access(float x)

  A method with same name but other parameter types.

  Parameters:

  x -

• finalize

  public void finalize()

  Example for a special finalize method body. finalize is called by garbage collection if the object is deleted finally. For Java2C in C all enhanced references will be deleted than. The finalize method is part of override-able methods of Object. The method will be placed in the method table.
  The C-code of this method has the following form:

   TODO copy from C
   

  Overrides:

  finalize in class java.lang.Object

• main

  public static void main(java.lang.String[] args)