@fastcar/core 0.2.63 → 0.3.0

package/README.md

@@ -64,7 +64,9 @@ Application 声明为一个应用
 
 Autowired 自动注入依赖的组件,现在等同为CallDependency
 
-CallDependency 调用时注入组件(调用对象可以不是组件 可以是一个普通类) 0.2.11版本以上生效
+CallDependency 调用时注入组件 0.2.11版本以上生效
+
+DemandInjection 当注入组件时在实例化对象时进行扫描注入  0.3.0版本以上生效
 
 AliasInjection 根据别名注入组件
 
@@ -261,8 +263,9 @@ class HelloConfig {
 ```ts
 //调用依赖版本示例
 import HelloService from "./HelloService";
-import { CallDependency } from "@fastcar/core/annotation";
+import { CallDependency, DemandInjection } from "@fastcar/core/annotation";
 
+@DemandInjection //如果没有标明是一个组件则需要使用该方法表明是一个延迟组件
 export default class CallService {
 
  //仅在调用时才会注入组件信息

package/annotation.d.ts

@@ -71,6 +71,9 @@ export function Autowired(target: any, propertyKey: string): void;
 //调用时注入类
 export function CallDependency(target: any, propertyKey: string): void;
 
+//按需注入加载
+export function DemandInjection(target: any): any;
+
 //异常方法类
 export function ExceptionMonitor(target: any): void;
 

package/index.d.ts

@@ -4,6 +4,8 @@ import { ComponentKind } from "./src/constant/ComponentKind";
 import { LifeCycleModule } from "./src/constant/LifeCycleModule";
 import { FIELDTYPE } from "./src/model/DataMap";
 import { ProcessType } from "./src/type/ProcessType";
+import { HotReloadEnum } from "./src/type/FileHotterDesc";
+import { ClassConstructor } from "./src/type/ClassConstructor";
 
 declare type ComponentDesc = {
 	id: string;
@@ -56,26 +58,29 @@ export class FastCarApplication extends Events {
 
 	/***
 	 * @version 1.0 热更新组件
+	 * @version 1.1 热更新配置文件
 	 */
 	addHot(): void;
 
-	/**
+	addDelayHot(fp: string, loadType: HotReloadEnum): void;
+
+	reloadFiles(): void;
+
+	/***
 	 * @version 1.0 获取资源路径
 	 */
 	getResourcePath(): string;
-
 	/***
 	 * @version 1.0 获取项目的基本路径
 	 *
 	 */
 	getBasePath(): string;
 
-	/***
-	 * @version 1.0 获取项目的基础资源路径
+	/**
+	 * @version 1.0 获取项目读取的基本配置路径
 	 */
 	getBaseName(): string;
-
-	/**
+	/***
 	 * @version 1.0 加载系统配置 加载顺序为 default json < yaml < env
 	 *
 	 */
@@ -83,29 +88,23 @@ export class FastCarApplication extends Events {
 
 	setSetting(key: string | symbol, value: any): void;
 
-	/**
+	/***
 	 * @version 1.0 获取自定义设置 设置优先级 配置自定义>系统配置>初始化
-	 * @param key
+	 *
 	 */
 	getSetting(key: string | symbol): any;
 
-	/**
+	/***
 	 * @version 1.0 获取应用配置
-	 * @return
 	 */
 	getapplicationConfig(): ApplicationConfig;
-
-	/**
+	/***
 	 * @version 1.0 扫描组件
+	 * @version 1.1 新增手动注入组件
+	 * @version 1.2 改成统一入口
 	 */
 	loadClass(): void;
 
-	/***
-	 * @version 1.0 装配单个模块
-	 * @deprecated 修改为主动查找时装配
-	 */
-	injectionModule(instance: any, instanceName: string | symbol): void;
-
 	/***
 	 * @version 1.0 根据名称获取组件的加载情况
 	 *
@@ -118,35 +117,45 @@ export class FastCarApplication extends Events {
 	 */
 	getComponentDetailByTarget(target: Object): ComponentDesc | undefined;
 
-	/**
-	 * @version 1.0 加载需要注入的类
-	 * @deprecated 修改为主动查找时装配
+	getInjectionUniqueKeyByFilePath(fp: string, name: string): string | symbol | null;
+	/***
+	 * @version 1.0 转成实例对象
+	 * @version 1.0.1 新增加载时识别载入配置选项
+	 *
 	 */
-	loadInjectionModule(): void;
+	convertInstance(classZ: any, fp: string): void;
 
-	/**
+	/***
 	 * @version 1.0 根据类型获取组件
-	 * @param name
-	 * @return
 	 */
 	getComponentByType(name: ComponentKind): any[];
 
-	/**
+	/***
 	 * @version 1.0 获取全部的组件列表
-	 * @return
 	 */
-	getComponentList(): any[];
-
-	/**
+	getComponentList(): (Object | ClassConstructor<Object>)[];
+	/***
 	 * @version 1.0 根据名称组件
-	 * @param name
 	 */
-	getComponentByName(name: string | symbol): any;
+	getComponentByName(name: string | symbol): Object | null;
+	/**
+	 * @version 1.0 组件改成按需加载的模式
+	 */
+	getBean(key: string | symbol): Object | null;
+
+	loadInjectionService(instance: Object): void;
+
+	loadLoggerIOC(instance: Object): void;
+
+	/***
+	 * @version 1.0 判断是否拥有组件名称
+	 */
+	hasComponentByName(name: string | symbol): boolean;
 
 	/***
 	 * @version 1.0 根据原型获取实例
 	 */
-	getComponentByTarget(target: Object): any;
+	getComponentByTarget<T>(target: Object): T | null;
 
 	/**
 	 * @version 1.0 获取组件详情列表
@@ -154,17 +163,13 @@ export class FastCarApplication extends Events {
 	 */
 	getComponentDetailsList(): ComponentDesc[];
 
-	/**
-	 * @version 1.0 判断组件是否存在
-	 */
-	hasComponentByName(name: string | symbol): boolean;
-
 	/**
 	 * @version 1.0 开启日志系统
+	 * @version 1.1 更改为采用winston日志
 	 */
 	startLog(): void;
 
-	/**
+	/***
 	 * @version 1.0 初始化应用
 	 */
 	init(): void;
@@ -173,6 +178,8 @@ export class FastCarApplication extends Events {
 	 * @version 1.0 退出事件监听
 	 *
 	 */
+	exitEvent(msg: string): Promise<void>;
+
 	addExitEvent(): void;
 
 	/***
@@ -180,28 +187,24 @@ export class FastCarApplication extends Events {
 	 */
 	addExecptionEvent(): void;
 
-	/**
+	/***
 	 * @version 1.0 自动调用方法
-	 * @param name
 	 */
-	automaticRun(name: LifeCycleModule): void;
+	automaticRun(name: LifeCycleModule): Promise<void>;
 
 	/**
 	 * @version 1.0 开启应用前执行的操作 加载配置,扫描组件，注入依赖组件
 	 */
 	beforeStartServer(): void;
-
-	/**
+	/***
 	 * @version 1.0 启动服务
 	 */
-	startServer(): void;
-
-	/**
+	startServer(): Promise<void>;
+	/***
 	 * @version 1.0 停止服务前自动调用服务
 	 */
-	beforeStopServer(): void;
-
-	/**
+	beforeStopServer(): Promise<void>;
+	/***
 	 * @version 1.0 停止服务
 	 */
 	stopServer(): void;
@@ -233,6 +236,10 @@ export class FastCarApplication extends Events {
 	 *
 	 */
 	isHotter(): boolean;
+	/***
+	 * @version 1.0 是否支持资源文件热更
+	 */
+	isHotterSysConfig(): boolean;
 
 	/**
 	 * @version 1.0 指定热更新文件

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@fastcar/core",
-	"version": "0.2.63",
+	"version": "0.3.0",
 	"homepage": "https://github.com/williamDazhangyu/fast-car",
 	"main": "target/index.js",
 	"author": "william_zhong",
@@ -29,12 +29,12 @@
 		"@fastcar/core"
 	],
 	"engines": {
-		"node": ">=16"
+		"node": ">=20"
 	},
 	"dependencies": {
-		"reflect-metadata": "^0.1.13",
+		"reflect-metadata": "^0.2.2",
 		"winston": "^3.10.0",
-		"yaml": "^1.10.2"
+		"yaml": "^2.6.1"
 	},
 	"devDependencies": {
 		"@types/mocha": "^9.0.0",