org.noear.solon

类 XApp

java.lang.Object

org.noear.solon.XApp

所有已实现的接口:

XHandler

public class XApp
extends Object
implements XHandler

插件式微型Web框架(70kb) 框架主要有几部份组成： 1.微框架体系 2.插件体系 3.注解体系(为 mvc, prc 提供支持) //Bean分为：普通Bean和Web Bean ///设计目标:: 1.更高的性能（弱化字段级注入，减少不必要的反射） 2.更轻量的结构、更强的扩展性 3.为Spring之外提供另一个选择 ///保持手写和注解两种体验方案:: ///关于Bean扫描和加载机制:: #XBean 为一般bean,会被加载 (仅支持类级别) #XController, #XInterceptor 为特定bean,会被加载 (仅支持类级别) 其中：#XController (控制器), #XInterceptor (拦截器), #XBean(remoting=true)(服务) 会自动注入到 XApp.router //这三者最终都会转换为：XAction 其中：#XController 加在 XHandler上， 会自动注入到 XApp.router #XBean 加在 XPlugin上，会自运注入到 XApp.plug() #XBean 加在普通类上，会自动注入到 XApp.beans ///插件(XPlugin)的作用:: 1.扩展框架机能 2.按需定制架构 3.可让业务开发时分散、打包时合并； ///XMapping的策略 1.与Spring保持相近 2.编写更好性能的方法（根级map: /开头，子级map: 不要/开头；） ///更新日志： 20190109:为path var添加_支持 20190110:添加stop事件支持； 添加XContent.paramValues(k)->[]； 添加XContent.paramAsEntity(c)->t; 添加XParam，支持XAction模型参数 20190111:添加Aop扩展机制

字段概要

字段

限定符和类型	字段和说明
boolean	enableHttp
boolean	enableSocket
boolean	enableWebSocket

构造器概要

构造器

限定符	构造器和说明
protected	XApp(XMap args)

方法概要

限定符和类型	方法和说明
void	add(String expr, XMethod method, XHandler handler) 主体监听
void	after(String expr, XMethod method, int index, XHandler handler)
void	after(String expr, XMethod method, XHandler handler) 重置监听
void	all(String path, XHandler handler) 添加所有方法的监听（GET,POST,PUT,PATCH,DELETE,HEAD）
void	before(String expr, XMethod method, int index, XHandler handler)
void	before(String expr, XMethod method, XHandler handler) 前置监听
static XProperties	cfg()
void	delete(String path, XHandler handler) 添加DELETE方法的监听（REST.delete 从服务端删除资源）
void	get(String path, XHandler handler) 添加GET方法的监听（REST.select 从服务端获取一或多项资源）
static XApp	global() 唯一实例
void	handle(XContext x) 统一代理入口
XHandler	handlerGet()
void	handlerSet(XHandler handler)
void	loadBean(Class<?> source) 加载Bean
XApp	onError(Act2<XContext,Throwable> event)
void	onSharedAdd(Act2<String,Object> event)
void	patch(String path, XHandler handler) 添加PATCH方法的监听（REST.update 客户端提供改变的属性）
void	plug(XPlugin plugin) 插入插件
int	port() 获取端口
void	post(String path, XHandler handler) 添加POST方法的监听（REST.create 在服务端新建一项资源）
XProperties	prop() 获取属性
void	put(String path, XHandler handler) 添加PUT方法的监听（REST.update 客户端提供改变后的完整资源）
XRouter	router()
void	send(String path, XHandler handler) 添加SEND方法的监听（on web send）
Map<String,Object>	shared()
void	sharedAdd(String key, Object obj)
<T> void	sharedGet(String key, Act1<T> event)
static XApp	start(Class<?> source, String[] args) 启动应用（全局只启动一个），执行序列 1.加载配置（约定：application.properties 为应用配置文件） 2.加载自发现插件（约定：/solonplugin/*.properties 为插件配置文件） 3.加载注解Bean（约定：@XBean,@XController,@XInterceptor 为bean） 4.执行Bean加载事件（采用：注册事件的方式进行安需通知）
static XApp	start(Class<?> source, String[] args, Act1<XApp> builder)
static XApp	start(Class<?> source, XMap argx, Act1<XApp> builder)
static void	stop() 停止服务（为web方式停止服务提供支持）

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

enableHttp

public boolean enableHttp

enableWebSocket

public boolean enableWebSocket

enableSocket

public boolean enableSocket

构造器详细资料

XApp

protected XApp(XMap args)

方法详细资料

global

public static XApp global()

唯一实例

cfg

public static XProperties cfg()

start

public static XApp start(Class<?> source,
                         String[] args)

启动应用（全局只启动一个），执行序列

1.加载配置（约定：application.properties 为应用配置文件） 2.加载自发现插件（约定：/solonplugin/*.properties 为插件配置文件） 3.加载注解Bean（约定：@XBean,@XController,@XInterceptor 为bean） 4.执行Bean加载事件（采用：注册事件的方式进行安需通知）

start

public static XApp start(Class<?> source,
                         String[] args,
                         Act1<XApp> builder)

start

public static XApp start(Class<?> source,
                         XMap argx,
                         Act1<XApp> builder)

stop

public static void stop()

停止服务（为web方式停止服务提供支持）

loadBean

public void loadBean(Class<?> source)

加载Bean

sharedAdd

public void sharedAdd(String key,
                      Object obj)

sharedGet

public <T> void sharedGet(String key,
                          Act1<T> event)

onSharedAdd

public void onSharedAdd(Act2<String,Object> event)

shared

public Map<String,Object> shared()

router

public XRouter router()

port

public int port()

获取端口

prop

public XProperties prop()

获取属性

plug

public void plug(XPlugin plugin)

插入插件

before

public void before(String expr,
                   XMethod method,
                   XHandler handler)

前置监听

before

public void before(String expr,
                   XMethod method,
                   int index,
                   XHandler handler)

after

public void after(String expr,
                  XMethod method,
                  XHandler handler)

重置监听

after

public void after(String expr,
                  XMethod method,
                  int index,
                  XHandler handler)

add

public void add(String expr,
                XMethod method,
                XHandler handler)

主体监听

all

public void all(String path,
                XHandler handler)

添加所有方法的监听（GET,POST,PUT,PATCH,DELETE,HEAD）

get

public void get(String path,
                XHandler handler)

添加GET方法的监听（REST.select 从服务端获取一或多项资源）

post

public void post(String path,
                 XHandler handler)

添加POST方法的监听（REST.create 在服务端新建一项资源）

put

public void put(String path,
                XHandler handler)

添加PUT方法的监听（REST.update 客户端提供改变后的完整资源）

patch

public void patch(String path,
                  XHandler handler)

添加PATCH方法的监听（REST.update 客户端提供改变的属性）

delete

public void delete(String path,
                   XHandler handler)

添加DELETE方法的监听（REST.delete 从服务端删除资源）

send

public void send(String path,
                 XHandler handler)

添加SEND方法的监听（on web send）

handlerGet

public XHandler handlerGet()

handlerSet

public void handlerSet(XHandler handler)

handle

public void handle(XContext x)
            throws Throwable

统一代理入口

指定者:

handle 在接口中 XHandler

抛出:

Throwable

onError

public XApp onError(Act2<XContext,Throwable> event)