---

KKernel Class Reference

Collaboration diagram for KKernel:

[legend]List of all members.

Static Public Methods
Context	newConfiguration (Context _context, Class _c)
Static Private Attributes
Container	containers = null
ConfigurationFactory	configuration_factory = new JConfigurationFactory()

---

Detailed Description

Bootstrap class of the jonathan configuration mechanism. Provides the runtime configuration file mechanism by using XML decoders and loads the java system properties.

Must be provided in the application's compiled configuration by specifying the bootstrap attribute of the root context in the XML configuration file to be compiled. KKernel is loaded in the java code of the compiled configuration file.

<U>jonathan's example of KKernel use:</U>

• the compiled configuration file is Kernel.java; it is obtained from its XML source Kernel.kcf by the XML2Kernel tool. Its class name (Kernel) is provided in the XML source by the generated attribute of the root context.
• the runtime configuration file is jonathan.xml; its is provided as the property named "/jonathan/KKernel/runtime_configuration_file" in the Kernel.kcf.
• the runtime configuration file is decoded by an implementation of the interface File2Configuration (in fact an OpenXMLDecoder) whose configuration is provided in Kernel.kcf. as an assemblage named /jonathan/KKernel/xml_decoder. The decoder is instanciated by the configuration bootstrap class KKernel.
• the whole mechanism is triggered by the ORBClass setParameters() method, which calls the static Kernel.newConfiguration() method and returns jonathan's whole runtime configuration.

Definition at line 74 of file KKernel.java.

---

Member Function Documentation

Context KKernel::newConfiguration ( Context _context, Class _c ) [inline, static]

The jonathan Kernel's runtime bootstrap mechanism. This method loads its context parameter's /jonathan/KKernel/xml_decoder value; it must be an implementation of File2Configuration loads its context parameter's /jonathan/KKernel/runtime_configuration_file String property and decodes the corresponding runtime configuration file with the previously loaded decoder; the decoded components are imported in a duplicata of the given Context parameter. loads its context parameter's /jonathan/KKernel/properties_decoder (it must be an implementation of Properties2Configuration) and uses it to import the java System properties Parameters: _context   the compiled configuration to bootstrap on _c   Returns: the application's complete runtime configuration Definition at line 101 of file KKernel.java. { ClassLoader $loader = null; try { $loader = _c.getClassLoader(); } catch (Exception e) { e.printStackTrace(); } Container $current = containers; while ($current != null) { if ($loader == $current.loader && _context == $current.source) { return $current.returned_context; } else { $current = $current.next; } } ClassPathFinder $class_path_finder = new ClassPathFinderImpl($loader); Context $toBeReturned = configuration_factory.newContext(_context,$class_path_finder); Object $xml_file_name = null; try { $xml_file_name = System.getProperty("jonathan.KKernel.runtime_configuration_file"); } catch (Exception _) { } if ($xml_file_name == null) { $xml_file_name = _context.getValue("/jonathan/KKernel/runtime_configuration_file",'/'); } if ($xml_file_name instanceof String) { Object $component = $toBeReturned.getValue("/jonathan/KKernel/xml_decoder",'/'); if ($component instanceof File2Configuration) { File2Configuration $xml_decoder = (File2Configuration) $component; try { $xml_decoder.importElement($toBeReturned,(String) $xml_file_name,configuration_factory, $class_path_finder); } catch (JonathanException e) { Exception actual = e.represents(); if (actual instanceof IOException) { System.err.println("Warning : error when trying to import the runtime configuration from " + $xml_file_name +": " + e); $toBeReturned = configuration_factory.newContext(_context,$class_path_finder); } else { System.err.println("Error importing the runtime configuration from " + $xml_file_name +"."); e.printStackTrace(); } } } else { System.err.println("Warning: no XML decoder associated with KKernel to read input from " + $xml_file_name); } } Properties system_properties = null; try { system_properties = System.getProperties(); } catch (SecurityException ignored) { ignored.printStackTrace(); } if (system_properties != null) { Object $component = $toBeReturned.getValue("/jonathan/KKernel/properties_decoder",'/'); if ($component instanceof Properties2Configuration) { Properties2Configuration $properties_decoder = (Properties2Configuration) $component; try { $properties_decoder.importProperties($toBeReturned, system_properties, new String[] {"java.", "file."}, true); } catch (JonathanException e) { System.err.println("Warning : error when trying to import system properties: " + e); } } else { System.err.println("Warning: no properties decoder associated with KKernel to\n" + " import the system properties."); } } // ------------------- containers = new Container(_context,$loader,$toBeReturned,containers); return $toBeReturned; }

---

Member Data Documentation

ConfigurationFactory KKernel::configuration_factory = new JConfigurationFactory() [static, private]

Definition at line 77 of file KKernel.java.

Container KKernel::containers = null [static, private]

Definition at line 76 of file KKernel.java.

---

The documentation for this class was generated from the following file:

• KKernel.java

---