Skip to content
Aspectran is a Java framework for building Web and command-line applications.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Aspectran - Java application framework

Build Status Coverage Status Maven central DepShield Badge License



Aspectran is a concise, easy-to-use Java application framework. Some of the widely used Java application frameworks are becoming more and more complex with more features as they mature. A typical example would be the Spring Framework. Aspectran is a single-structure, next-generation framework that incorporates some of the key features of the Spring Framework with new perspectives.

Aspectran consists of the following core functions:

  • Support multiple execution environments with identical configuration settings
    You can share the same configuration settings in different execution environments, such as Web and CLI-based applications.
  • Support POJO (Plain Old Java Object) programming model
    Rather than inheriting certain classes and extending functionality, you can concentrate on implementing the functionality that is actually needed. The result value can be returned as the simplest Java object.
  • Support Inversion of Control (IoC)
    The framework controls the overall flow and invokes the functionality of the module created by the developer. Provides the ability to manage the creation and lifecycle of objects, allowing developers to focus on business logic.
  • Support Dependency Injection (DI)
    The framework links modules that depend on each other at runtime. It can maintain low coupling between modules and increase code reusability.
  • Support Aspect-Oriented Programming (AOP)
    You can write code by separating core functions and additional functions. Once the core functionality implementation is complete, features such as transactions, logging, security, and exception handling can be combined with core functionality.
  • Support building RESTful Web Services
    Aspectran is designed to be suitable for building RESTful Web Services.

Aspectran provides the environment to build web application server and shell application easily based on the above core functions. In addition, it enables rapid execution and deployment. Java code written in POJO with Aspectran's powerful and concise configuration settings facilitates testing and maximizes code reuse when developing applications in other execution environments.

The following packages based on the com.aspectran.core package exist to support various execution environments.

  • com.aspectran.daemon: Provides a daemon that runs Aspectran as a service in the background on Unix-based or Windows operating systems
  • com.aspectran.embed: Provides an interface that can be used by embedding Aspectran in Java applications
  • Provides an interactive shell that lets you use or control Aspectran directly from the command line
  • Provides an interactive shell using the feature-rich JLine
  • com.aspectran.web: Provides overall functionality for building web applications within a web application container
  • com.aspectran.jetty: Add-on package for integrating Embedded Jetty
  • com.aspectran.mybatis: Add-on package for integrating MyBatis

Maven dependencies

Use the following definition to use Aspectran in your maven project:


Aspectran can also be used with more low-level jars:

<!-- This can be used to build a daemon application that runs in the background. -->
<!-- This can be used to build command-line based applications. -->
<!-- This can be used to build command-line based applications that use the feature-rich JLine. -->
<!-- This can be used to build web applications. -->
<!-- This can be used to embed Aspectran in your application. -->
<!-- This can be used to build a web application server with built-in Jetty. -->
<!-- This can be used to build applications that use MyBatis. -->



  • Maven 3.3+ (prefer included maven-wrapper)
  • Java 8+

Check out and build:

git clone git://
cd aspectran
./build rebuild

Running the demo

To run the demo, simply use the following command after having build Aspectran

./build demo

Continuous Integration



Aspectran is Open Source software released under the Apache 2.0 license.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.