Apache Polygene™ Java 教程

项目介绍

Apache Polygene™ (Java Edition) 是一个基于 Java 平台的复合面向编程（Composite Oriented Programming）框架。它结合了面向切面编程（AOP）、依赖注入（DI）和领域驱动设计（DDD）的概念，允许开发者使用比类更小的片段，并将这些片段组合成更大的复合体，这些复合体的行为类似于常规对象。

Polygene™ 还解决了应用程序组合的强制执行问题，即复合体在模块中声明，模块包含在层中，层之间的访问受到控制和强制执行。

项目快速启动

环境准备

确保你已经安装了以下工具：

• JDK 8 或更高版本
• Gradle
• Git

克隆项目

git clone https://github.com/apache/polygene-java.git
cd polygene-java

构建项目

gradle build

创建一个简单的 Polygene 应用程序

1. 创建一个新的 Gradle 项目，并在 build.gradle 文件中添加以下依赖：

plugins {
    id 'java'
    id 'polygene-settings'
}

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.apache.polygene:polygene-core:3.0.0'
}

2. 创建一个简单的 Polygene 应用程序：

import org.apache.polygene.api.composite.Composite;
import org.apache.polygene.api.mixin.Mixins;
import org.apache.polygene.api.structure.Application;
import org.apache.polygene.api.structure.Module;
import org.apache.polygene.bootstrap.ApplicationAssembler;
import org.apache.polygene.bootstrap.ApplicationAssembly;
import org.apache.polygene.bootstrap.AssemblyException;
import org.apache.polygene.bootstrap.Energy4Java;

public class SimpleApp {
    public static void main(String[] args) throws Exception {
        Energy4Java polygene = new Energy4Java();
        Application app = polygene.newApplication(new ApplicationAssembler() {
            @Override
            public ApplicationAssembly assemble(ApplicationAssemblyFactory factory) throws AssemblyException {
                ApplicationAssembly assembly = factory.newApplicationAssembly();
                Module module = assembly.layer("Layer").module("Module");
                module.transients(HelloComposite.class);
                return assembly;
            }
        });
        app.activate();

        HelloComposite hello = app.findModule("Layer", "Module").newTransient(HelloComposite.class);
        System.out.println(hello.sayHello("World"));
    }

    @Mixins(HelloMixin.class)
    public interface HelloComposite extends Composite {
        String sayHello(String name);
    }

    public static class HelloMixin implements HelloComposite {
        @Override
        public String sayHello(String name) {
            return "Hello, " + name + "!";
        }
    }
}

应用案例和最佳实践

应用案例

Apache Polygene™ 可以用于构建复杂的领域模型，特别是在需要高度模块化和可扩展性的应用程序中。例如，它可以用于构建企业级应用程序、微服务架构和复杂的业务流程管理系统。

最佳实践

1. 模块化设计：将应用程序分解为多个模块，每个模块负责一个特定的功能区域。
2. 依赖注入：使用 Polygene™ 的依赖注入功能来管理对象之间的依赖关系。
3. 面向切面编程：使用 AOP 来处理横切关注点，如日志记录、安全性和事务管理。
4. 领域驱动设计：采用 DDD 的原则来设计领域模型，确保业务逻辑的清晰和一致性。

典型生态项目

Apache Polygene™ 的生态系统包括多个库和工具，这些库和工具扩展了其功能并提供了额外的支持。以下是一些典型的生态项目：

1. Polygene™ Libraries：提供了一系列的库，如日志记录、HTTP、SQL、REST 等，以支持常见的应用程序需求。
2. Polygene™ Tools：包括用于开发和调试的工具，如 IDE 插件和代码生成器。
3. Polygene™ Extensions