Solon 开源项目安装与使用指南

Solon 开源项目安装与使用指南

solon🔥 New Java application development framework: FASTER, SMALLER, SIMPLER!! Startup is 5-10 times faster. 2 ~ 3 times higher qps; Runtime memory saving 1/3 ~ 1/2; Packs can be shrunk to 1/2 to 1/10项目地址:https://gitcode.com/gh_mirrors/so/solon

目录结构及介绍

在克隆或下载 Solon 项目后, 你会看到以下核心目录和文件：

根目录下主要子目录说明:

• solon/: 主要应用框架的核心功能实现所在。

  • 包含了 Solon 的基础框架组件, 如 Solon Core, Solon Web 等。

• solon-cloud/: 提供了云原生特性的扩展, 比如配置中心、服务发现等。

  • 这里包含了 Solon Cloud 配套的服务治理相关功能。

• solon-docs/: 文档区域, 包括了各类使用指南和技术白皮书。

• solon-samples/: 示例项目集合, 展示如何使用 Solon 构建不同类型的微服务。

根目录下重要文件:

• README.md: 项目的总体介绍, 包含快速上手指导、特性概述等。
• .gitignore: Git 的忽略规则文件, 定义哪些文件不应该被版本控制系统跟踪。

项目的启动文件介绍

Solon 的启动方式灵活多样, 但最常见的有以下两种模式：

1. 使用 solon-boot.jar

这是打包后的单文件应用程序, 可以直接通过命令行启动:

java -jar solon-boot.jar --spring.profiles.active=dev

这里指定了使用开发环境(dev)的配置。

2. 从 IDE 启动

如果你选择在集成开发环境中开发 Solon 应用, 则通常可以从主类中启动程序。

主类介绍

主类通常继承自noear.solon.SolonApp, 或者注解@SpringBootApplication来标识这是一个 Solon/Spring Boot 的入口点。

示例代码：

package com.example;

import noear.solon.Solon;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.ConfigurableApplicationContext;

@SpringBootApplication
public class AppMain {
    
    public static void main(String[] args) {
        // 直接调用Solon的启动方法
        Solon.start(AppMain.class, args);
        
        /* 或者使用 Spring Boot 方式启动
        ConfigurableApplicationContext context = SpringApplication.run(AppMain.class, args);
        */
    }
}

项目的配置文件介绍

Solon 支持多种配置文件格式, 最常用的是 YAML 和 properties 文件。

默认位置和命名规则

• YAML: application.yml 或 application.yaml
• Properties: application.properties

这些文件通常位于项目的根目录下或者src/main/resources目录内。

配置项详解

基础配置项

Solon 的配置覆盖了应用的各个方面, 下面列举几个基本的例子：

• 环境选择:

spring:
  profiles:
    active: dev # 激活 dev 环境配置

• 端口绑定:

server:
  port: 8080 # 设置 HTTP 服务器监听的端口号

• 日志级别:

logging:
  level: info # 整体的日志记录等级设定为 info 级别

• 数据源配置:

spring:
  datasource:
    driver-class-name: com.mysql.jdbc.Driver
    url: jdbc:mysql://localhost/testdb?useUnicode=true&characterEncoding=UTF-8
    username: root
    password: secret

以上简明介绍了 Solon 的项目目录、启动流程以及配置机制的关键细节。随着对框架的深入了解, 你会发现更多高级特性和定制化选项。

solon🔥 New Java application development framework: FASTER, SMALLER, SIMPLER!! Startup is 5-10 times faster. 2 ~ 3 times higher qps; Runtime memory saving 1/3 ~ 1/2; Packs can be shrunk to 1/2 to 1/10项目地址:https://gitcode.com/gh_mirrors/so/solon