Get started

Okra是一个构建在Netty框架和Disruptor框架之上轻量级JAVA服务器框架。使用Netty实现高性能，可灵活扩展的网络通信，使用Disruptor实现高吞吐量，低延迟的并发。

如何将Okra应用到实际开发中?

本文旨在帮助初次接触Okra框架的用户上手使用Okra框架.

1. 下载Okra-x.y.z.jar

首先我们需要下载Okra框架最新的稳定版本.Jar:下载地址.

目前Okra没有推送到Maven仓库,使用Okra-x.y.z.jar需要手动添加类库引用.

2. 导入工程

本文以Intellij IDEA 2016.1.2为例. IDEA提供多种多样的添加类库的途径. 本段只做简单的举例示范.

方法一: 设置通用类库导入

打开工程设置. "File" -> "Project Structure..." 或者使用快捷键(Ctrl + Alt + + Shift + S).
选择"Global Libraries", 点击符号"+"，添加Okra-x.y.z.jar为通用类库.
添加Okra到工程中, 选中新添加的Okra-x.y.z.jar点击鼠标右键 -> "Add to Modules" 选中对应的模块, 最终"Ok", 完成导入

方法二: 在Modules界面设置导入

打开工程设置. "File" -> "Project Structure..." 或者使用快捷键(Ctrl + Alt + + Shift + S).
选择"Modules"，选中需要添加Okra的模块, 点击"Dependencies", 点击符号"+".
点击"JARs or directories"选择Okra文件或所在目录按照提示完成添加

3. Okra框架的依赖

Okra核心是整合Netty和Disruptor两个框架. 以便于快速开发高并发, 低延迟，高吞吐量，灵活可扩展的网络服务器.

(required) :

<dependency>
    <groupId>io.netty</groupId>
    <artifactId>netty-all</artifactId>
    <version>4.0.36.Final</version>
</dependency>
<dependency>
    <groupId>com.lmax</groupId>
    <artifactId>disruptor</artifactId>
    <version>3.3.2</version>
</dependency>

(optional) :

Spring框架支持

使用Spring框架, 除了Spring框架自身带来的IOC等便利之外, 还可以快速集成大量优秀的类库, 例如: Hibernate, Mybatis, BoneCP, HikariCP等等.
```
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-context</artifactId>
    <version>4.2.2.RELEASE</version>
</dependency>
```

Flex通信支持

Flex客户端和Java服务端的通信支持依赖于BlazeDS类库.

<dependency>
    <groupId>org.apache.flex.blazeds</groupId>
    <artifactId>flex-messaging-core</artifactId>
    <version>4.7.2</version>
</dependency>
<dependency>
    <groupId>org.apache.flex.blazeds</groupId>
    <artifactId>flex-messaging-common</artifactId>
    <version>4.7.2</version>
</dependency>

4. 项目中使用

示例1: Okra框架搭建HTTP服务器

示例2: Okra框架搭建Socket服务器

Java服务器Demo: okra-demo

5. 总结

本文旨在帮助初次接触Okra框架的用户，快速搭建基于Okra的网络服务器. 提供了两个简单的示例和一个相对来说比较完整的服务端demo. 用户在实际开发过程中遇到问题或者BUG欢迎反馈到**issues**.

Provide feedback

Saved searches