How wso2/carbon-kernel works
Carbon Kernel is a lightweight OSGi server runtime and development platform. Its main operational flow is a server operator launching the Carbon server, which starts the OSGi-based runtime; kernel services then support component startup ordering and runtime lifecycle management. Separate capabilities cover server monitoring and context access, bundle deployment, and developer tools and archetypes. The README documents these capabilities, but only selected source files were excerpted, so several subsystem relationships are documented at the README level rather than traced through implementation.
Main entry points: CarbonServer.java Carbon server · CarbonTool.java Carbon tool API · StartupComponentManager.java Startup resolver · Main.java Server launcher
Components 22
Launch and deployment
- Server launcher
launcher/src/main/java/org/wso2/carbon/launcher/Main.java - Carbon server
launcher/src/main/java/org/wso2/carbon/launcher/CarbonServer.java - OSGi lib deployer
launcher/src/main/java/org/wso2/carbon/launcher/extensions/OSGiLibBundleDeployer.java
Kernel services
- Startup resolver
core/src/main/java/org/wso2/carbon/kernel/internal/startupresolver/StartupComponentManager.java - Capability model
core/src/main/java/org/wso2/carbon/kernel/internal/startupresolver/beans/Capability.java - OSGi service capability
core/src/main/java/org/wso2/carbon/kernel/internal/startupresolver/beans/OSGiServiceCapability.java - Capability listeners
core/src/main/java/org/wso2/carbon/kernel/startupresolver/RequiredCapabilityListener.java - Carbon context
core/src/main/java/org/wso2/carbon/kernel/context/CarbonContext.java - Kernel configuration
core/src/main/java/org/wso2/carbon/kernel/config/model/CarbonConfiguration.java
Runtime operations
- Runtime API
core/src/main/java/org/wso2/carbon/kernel/runtime/Runtime.java - Runtime management
core/src/main/java/org/wso2/carbon/kernel/internal/runtime/CarbonRuntimeService.java - Runtime registry
core/src/main/java/org/wso2/carbon/kernel/internal/runtime/RuntimeManager.java - JMX monitoring
core/src/main/java/org/wso2/carbon/kernel/internal/jmx/CarbonJMXComponent.java - Server logging
launcher/src/main/java/org/wso2/carbon/launcher/Main.java
Developer tools
- Carbon tool API
tools/tools-core/src/main/java/org/wso2/carbon/tools/CarbonTool.java - Bundle converter
tools/tools-core/src/main/java/org/wso2/carbon/tools/converter/BundleGeneratorTool.java - JAR installer
tools/tools-core/src/main/java/org/wso2/carbon/tools/InstallJarsTool.java - OSGi lib tool
tools/tools-core/src/main/java/org/wso2/carbon/tools/osgilib/OSGiLibDeployerTool.java - Native library tool
tools/tools-core/src/main/java/org/wso2/carbon/tools/spi/NativeLibraryProvider.java - Project archetypes
archetypes - In-container testing
pax-exam-container-carbon/org.wso2.carbon.container/src/main/java/org/wso2/carbon/container/CarbonTestContainer.java
Other components
- Server operator
Connections 22
- Server operator → Server launcher: starts
launcher/src/main/java/org/wso2/carbon/launcher/Main.java - Server launcher → Carbon server: launches
launcher/src/main/java/org/wso2/carbon/launcher/Main.java - Startup resolver → Capability model: tracks capabilities
core/src/main/java/org/wso2/carbon/kernel/internal/startupresolver/StartupComponentManager.java - Startup resolver → OSGi service capability: records service needs
core/src/main/java/org/wso2/carbon/kernel/internal/startupresolver/StartupComponentManager.java - Startup resolver → Capability listeners: registers listeners
core/src/main/java/org/wso2/carbon/kernel/internal/startupresolver/StartupComponentManager.java - Runtime management → Runtime registry: gets runtimes
core/src/main/java/org/wso2/carbon/kernel/internal/runtime/CarbonRuntimeService.java - Runtime management → Runtime API: controls runtimes
core/src/main/java/org/wso2/carbon/kernel/internal/runtime/CarbonRuntimeService.java - OSGi lib deployer → Carbon server: updates bundle data
launcher/src/main/java/org/wso2/carbon/launcher/extensions/OSGiLibBundleDeployer.java - Server launcher → Server logging: configures logging
launcher/src/main/java/org/wso2/carbon/launcher/Main.java - Carbon tool API → Bundle converter: implemented by
tools/tools-core/src/main/java/org/wso2/carbon/tools/converter/BundleGeneratorTool.java - Carbon tool API → JAR installer: implemented by
tools/tools-core/src/main/java/org/wso2/carbon/tools/InstallJarsTool.java - Carbon tool API → OSGi lib tool: implemented by
tools/tools-core/src/main/java/org/wso2/carbon/tools/osgilib/OSGiLibDeployerTool.java - Carbon tool API → Native library tool: implemented by
tools/tools-core/src/main/java/org/wso2/carbon/tools/spi/NativeLibraryProvider.java - Server operator → Carbon context: uses API
README.md - Carbon server → Startup resolver: orders components
README.md - Server operator → Runtime management: manages runtimes
README.md - Server operator → JMX monitoring: monitors server
README.md - Carbon server → Kernel configuration: uses configuration
README.md - Carbon server → OSGi lib deployer: loads bundles
README.md - Server operator → Bundle converter: converts JARs
README.md - Server operator → Project archetypes: creates projects
README.md - Server operator → In-container testing: tests in container
README.md