@fastcar/core 0.2.38

package/db.d.ts

@@ -0,0 +1,272 @@
+export enum OperatorEnum {
+	eq = "=",
+	neq = "!=",
+	gt = ">",
+	gte = ">=",
+	lt = "<",
+	lte = "<=",
+	like = "LIKE",
+	in = "IN",
+	isNUll = "ISNULL",
+	isNotNull = "IS NOT NULL",
+	inc = "+", //累加
+	dec = "-", //累减
+	multiply = "*", //累乘
+	division = "/", //累除
+}
+
+export enum JoinEnum {
+	and = "AND",
+	or = "OR",
+}
+
+export enum OrderEnum {
+	asc = "ASC",
+	desc = "DESC",
+}
+
+export type SqlValue = number | string | number[] | string[] | boolean | boolean[] | null | Date;
+
+//where表达式
+type SqlExpression =
+	| {
+			[key: string]: { [key: string]: SqlValue };
+	  }
+	| SqlValue;
+
+export type SqlWhere = { [key: string]: SqlExpression | SqlWhere };
+
+export type RowData = {
+	[key: string]: SqlValue | { operate: string; value: SqlValue };
+};
+
+export type OrderType = { [key: string]: OrderEnum };
+
+export type SqlDelete = {
+	where?: SqlWhere; //查询条件
+	limit?: number; //限制行数
+};
+
+export type SqlQuery = {
+	where?: SqlWhere; //查询条件
+	fields?: string[]; //查询出来的元素
+	groups?: string[]; //分组排序
+	orders?: OrderType; //排序
+	limit?: number; //限制行数
+	offest?: number; //偏移量
+};
+
+export type SqlUpdate = {
+	where?: SqlWhere; //查询条件
+	row: RowData;
+	limit?: number; //限制行数
+};
+
+export type RowType = {
+	sql: string;
+	args: any[];
+};
+
+export interface DBMapper<T> {
+	/***
+	 * @version 1.0 更新或者添加记录多条记录(一般用于整条记录的更新)
+	 */
+	saveORUpdate(rows: T | T[], ds?: string, sessionId?: string): Promise<number | string>;
+
+	/***
+	 * @version 1.0 插入单条记录返回主键
+	 */
+	saveOne(row: T, ds?: string, sessionId?: string): Promise<number | string>;
+
+	/***
+	 * @version 1.0 批量插入记录
+	 */
+	saveList(rows: T[], ds?: string, sessionId?: string): Promise<boolean>;
+
+	/***
+	 * @version 1.0 更新记录
+	 *
+	 */
+	update({ row, where, limit }: SqlUpdate, ds?: string, sessionId?: string): Promise<boolean>;
+
+	/****
+	 * @version 1.0 更新一条数据
+	 *
+	 */
+	updateOne(sqlUpdate: SqlUpdate, ds?: string, sessionId?: string): Promise<boolean>;
+
+	/***
+	 * @version 1.0 根据实体类的主键来更新数据
+	 *
+	 */
+	updateByPrimaryKey(row: T, ds?: string, sessionId?: string): Promise<boolean>;
+
+	/***
+	 * @version 1.0 根据条件进行查找
+	 */
+	select(conditions: SqlQuery, ds?: string, sessionId?: string): Promise<T[]>;
+
+	/***
+	 * @version 1.0 查询单个对象
+	 *
+	 */
+	selectOne(conditions?: SqlQuery, ds?: string, sessionId?: string): Promise<T | null>;
+
+	/***
+	 * @version 1.0 通过主键查找对象
+	 *
+	 */
+	selectByPrimaryKey(row: T, ds?: string, sessionId?: string): Promise<T | null>;
+
+	/***
+	 * @version 1.0 判定是否存在
+	 *
+	 */
+	exist(where: SqlWhere, ds?: string, sessionId?: string): Promise<boolean>;
+
+	/***
+	 * @version 1.0 统计符合条件的记录
+	 */
+	count(where: SqlWhere, ds?: string, sessionId?: string): Promise<number>;
+
+	/***
+	 * @version 1.0 按照条件删除记录
+	 */
+	delete(conditions: SqlDelete, ds?: string, sessionId?: string): Promise<boolean>;
+
+	/***
+	 * @version 1.0 删除某条记录
+	 */
+	deleteOne(where: SqlWhere, ds?: string, sessionId?: string): Promise<boolean>;
+
+	/***
+	 * @version 1.0 删除某条记录根据主键
+	 */
+	deleteByPrimaryKey(row: T, ds?: string, sessionId?: string): Promise<boolean>;
+}
+
+export class BaseMapper<T extends Object> implements DBMapper<T> {
+	protected tableName: string;
+	protected classZ: any; //映射的原型类
+	protected mappingMap: Map<string, MapperType>; //代码别名-映射关系
+	protected mappingList: MapperType[];
+	protected dbFields: Map<string, string>; //数据库别名-代码别名
+
+	protected getFieldName(name: string): string;
+
+	//格式化数据库数据转化为程序设计内的
+	protected setRow(rowData: Object): T;
+
+	protected setRows(rowDataList: Object[]): T[];
+
+	/***
+	 * @version 1.0 更新或者添加记录多条记录(一般用于整条记录的更新)
+	 */
+	saveORUpdate(rows: T | T[], ds?: string, sessionId?: string): Promise<number | string>;
+
+	/***
+	 * @version 1.0 插入单条记录返回主键
+	 */
+	saveOne(row: T, ds?: string, sessionId?: string): Promise<number | string>;
+
+	/***
+	 * @version 1.0 批量插入记录
+	 */
+	saveList(rows: T[], ds?: string, sessionId?: string): Promise<boolean>;
+
+	/***
+	 * @version 1.0 更新记录
+	 *
+	 */
+	update({ row, where, limit }: SqlUpdate, ds?: string, sessionId?: string): Promise<boolean>;
+
+	/****
+	 * @version 1.0 更新一条数据
+	 *
+	 */
+	updateOne(sqlUpdate: SqlUpdate, ds?: string, sessionId?: string): Promise<boolean>;
+
+	/***
+	 * @version 1.0 根据实体类的主键来更新数据
+	 *
+	 */
+	updateByPrimaryKey(row: T, ds?: string, sessionId?: string): Promise<boolean>;
+
+	/***
+	 * @version 1.0 根据条件进行查找
+	 */
+	select(conditions: SqlQuery, ds?: string, sessionId?: string): Promise<T[]>;
+
+	/***
+	 * @version 1.0 查询单个对象
+	 *
+	 */
+	selectOne(conditions?: SqlQuery, ds?: string, sessionId?: string): Promise<T | null>;
+
+	/***
+	 * @version 1.0 通过主键查找对象
+	 *
+	 */
+	selectByPrimaryKey(row: T, ds?: string, sessionId?: string): Promise<T | null>;
+
+	/***
+	 * @version 1.0 判定是否存在
+	 *
+	 */
+	exist(where: SqlWhere, ds?: string, sessionId?: string): Promise<boolean>;
+
+	/***
+	 * @version 1.0 统计符合条件的记录
+	 */
+	count(where: SqlWhere, ds?: string, sessionId?: string): Promise<number>;
+
+	/***
+	 * @version 1.0 按照条件删除记录
+	 */
+	delete(conditions: SqlDelete, ds?: string, sessionId?: string): Promise<boolean>;
+
+	/***
+	 * @version 1.0 删除某条记录
+	 */
+	deleteOne(where: SqlWhere, ds?: string, sessionId?: string): Promise<boolean>;
+
+	/***
+	 * @version 1.0 删除某条记录根据主键
+	 */
+	deleteByPrimaryKey(row: T, ds?: string, sessionId?: string): Promise<boolean>;
+}
+
+export type MapperType = {
+	name: string; //量变名称
+	type: string; //类型
+	field: string; //数据库列名
+	dbType: string; //数据类型
+	primaryKey?: boolean; //是否为主键 默认为false
+	serialize?: Function; //序列化对象方法
+};
+
+export enum DesignMeta {
+	table = "db:table", //表名
+	field = "db:field", //列名
+	fieldMap = "db:fieldMap", //注入列名集合
+	dbType = "db:dbType", //数据类型
+	primaryKey = "db:primaryKey", //主键类型
+	entity = "db:entity", //实例化的数据库类
+	mapping = "db:mapping", //映射描述
+	dbFields = "db:fields", //数据库名-ts名
+	sqlSession = "SqlSession", //sql会话
+}
+
+export interface DataSourceManager {
+	createSession(): string;
+
+	destorySession(sessionId: string, status: boolean): void;
+
+	destorySession(sessionId: string, status: boolean): Promise<void>;
+
+	start(): void;
+
+	stop(): void;
+}
+
+export class SqlError extends Error {}

package/index.d.ts

@@ -0,0 +1,262 @@
+import * as Events from "events";
+import { ApplicationConfig } from "./src/config/ApplicationConfig";
+import { ComponentKind } from "./src/constant/ComponentKind";
+import { LifeCycleModule } from "./src/constant/LifeCycleModule";
+import { FIELDTYPE } from "./src/model/DataMap";
+import { ProcessType } from "./src/type/ProcessType";
+
+declare type ComponentDesc = {
+	id: string;
+	name: string;
+	path: string;
+};
+
+export * from "./src/config/SysConfig";
+
+export * from "./src/config/ApplicationConfig";
+
+export * from "./src/constant/LifeCycleModule";
+
+export * from "./src/constant/ComponentKind";
+
+export * from "./src/constant/BootPriority";
+
+//元数据加载模块
+export * from "./src/constant/FastCarMetaData";
+
+//自定义常量模块
+export * from "./src/constant/CommonConstant";
+
+//生命周期约定
+export * from "./src/interface/ApplicationHook";
+
+export { FIELDTYPE } from "./src/model/DataMap";
+
+export abstract class Logger {
+	abstract info(...args: any[]): void;
+
+	abstract debug(...args: any[]): void;
+
+	abstract warn(...args: any[]): void;
+
+	abstract error(...args: any[]): void;
+}
+
+export class FastCarApplication extends Events {
+	/***
+	 * @version 1.0 根据原型加载注入的方法
+	 *
+	 */
+	getInjectionUniqueKey(target: Object): string;
+
+	/**
+	 * @version 1.0 自身作为一个组件注入进去
+	 */
+	loadSelf(): void;
+
+	/***
+	 * @version 1.0 热更新组件
+	 */
+	addHot(): void;
+
+	/**
+	 * @version 1.0 获取资源路径
+	 */
+	getResourcePath(): string;
+
+	/***
+	 * @version 1.0 获取项目的基本路径
+	 *
+	 */
+	getBasePath(): string;
+
+	/**
+	 * @version 1.0 加载系统配置 加载顺序为 default json < yaml < env
+	 *
+	 */
+	loadSysConfig(): void;
+
+	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 扫描组件
+	 */
+	loadClass(): void;
+
+	/***
+	 * @version 1.0 装配单个模块
+	 * @deprecated 修改为主动查找时装配
+	 */
+	injectionModule(instance: any, instanceName: string | symbol): void;
+
+	/***
+	 * @version 1.0 根据名称获取组件的加载情况
+	 *
+	 */
+	getComponentDetailByName(name: string | symbol): ComponentDesc | undefined;
+
+	/***
+	 * @version 1.0 根据原型获取组件的加载信息
+	 *
+	 */
+	getComponentDetailByTarget(target: Object): ComponentDesc | undefined;
+
+	/**
+	 * @version 1.0 加载需要注入的类
+	 * @deprecated 修改为主动查找时装配
+	 */
+	loadInjectionModule(): void;
+
+	/**
+	 * @version 1.0 根据类型获取组件
+	 * @param name
+	 * @return
+	 */
+	getComponentByType(name: ComponentKind): any[];
+
+	/**
+	 * @version 1.0 获取全部的组件列表
+	 * @return
+	 */
+	getComponentList(): any[];
+
+	/**
+	 * @version 1.0 根据名称组件
+	 * @param name
+	 */
+	getComponentByName(name: string | symbol): any;
+
+	/***
+	 * @version 1.0 根据原型获取实例
+	 */
+	getComponentByTarget(target: Object): any;
+
+	/**
+	 * @version 1.0 获取组件详情列表
+	 *
+	 */
+	getComponentDetailsList(): ComponentDesc[];
+
+	/**
+	 * @version 1.0 开启日志系统
+	 */
+	startLog(): void;
+
+	/**
+	 * @version 1.0 初始化应用
+	 */
+	init(): void;
+
+	/***
+	 * @version 1.0 退出事件监听
+	 *
+	 */
+	addExitEvent(): void;
+
+	/***
+	 * @version 1.0 异常事件进行监听 不至于程序异常直接退出
+	 */
+	addExecptionEvent(): void;
+
+	/**
+	 * @version 1.0 自动调用方法
+	 * @param name
+	 */
+	automaticRun(name: LifeCycleModule): void;
+
+	/**
+	 * @version 1.0 开启应用前执行的操作 加载配置,扫描组件，注入依赖组件
+	 */
+	beforeStartServer(): void;
+
+	/**
+	 * @version 1.0 启动服务
+	 */
+	startServer(): void;
+
+	/**
+	 * @version 1.0 停止服务前自动调用服务
+	 */
+	beforeStopServer(): void;
+
+	/**
+	 * @version 1.0 停止服务
+	 */
+	stopServer(): void;
+
+	/**
+	 * @version 1.0 获取app名称
+	 */
+	getApplicationName(): string;
+
+	/***
+	 * @version 1.0 获取系统日志
+	 *
+	 */
+	getSysLogger(): Logger;
+
+	/***
+	 * @version 0.2.11 根据名称获取logger
+	 *
+	 */
+	getLogger(category?: string): Logger;
+
+	/***
+	 * @version 1.0 获取文件内容
+	 */
+	getFileContent(fp: string): string;
+
+	/***
+	 * @version 1.0 是否支持热更
+	 *
+	 */
+	isHotter(): boolean;
+
+	/**
+	 * @version 1.0 指定热更新文件
+	 *
+	 */
+	specifyHotUpdate(fp: string): void;
+
+	/***
+	 * @version 1.0 获取进程的信息
+	 *
+	 */
+	getMemoryUsage(): ProcessType;
+}
+
+//校验错误
+export class ValidError {
+	message?: string;
+}
+
+export class DataMap<K, V extends Object> extends Map<K, V> {
+	toValues(): V[];
+
+	toKeys(): K[];
+
+	//构造一个字典对象
+	toObject(): { [key: string]: V };
+
+	//自定义排序 支持多个排序
+	sort(sorts?: FIELDTYPE[], list?: V[]): V[];
+
+	/***
+	 * @version 1.0 查找属性名称
+	 * @params atts代表属性键值对匹配
+	 *
+	 */
+	findByAtts(atts: { [key: string]: any }): V[];
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+	"name": "@fastcar/core",
+	"version": "0.2.38",
+	"homepage": "https://github.com/williamDazhangyu/fast-car",
+	"main": "target/index.js",
+	"author": "william_zhong",
+	"license": "MIT",
+	"types": "index.d.ts",
+	"exports": {
+		".": "./target/index.js",
+		"./annotation": "./target/annotation.js",
+		"./utils": "./target/utils.js",
+		"./db": "./target/db.js"
+	},
+	"files": [
+		"src",
+		"target",
+		"test",
+		"index.d.ts",
+		"annotation.d.ts",
+		"db.d.ts",
+		"utils.d.ts",
+		"LICENSE"
+	],
+	"keywords": [
+		"ioc",
+		"spring",
+		"node",
+		"fastcar-core"
+	],
+	"engines": {
+		"node": ">=16"
+	},
+	"dependencies": {
+		"reflect-metadata": "^0.1.13",
+		"winston": "^3.6.0",
+		"yaml": "^1.10.2"
+	},
+	"devDependencies": {
+		"@types/mocha": "^9.0.0",
+		"@types/node": "^16.11.7",
+		"@types/reflect-metadata": "^0.1.0",
+		"@types/yaml": "^1.9.7",
+		"typescript": "^4.4.2"
+	},
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/williamDazhangyu/fast-car.git"
+	},
+	"scripts": {
+		"build": "tsc"
+	}
+}