综合前置平台详细设计说明书v0.3

综合前置平台详细设计说明书综合前置平台项目组

2013年7月

详细设计说明书

目录

1

引言............................................................................................................................................ 14

1.1 1.2 1.3 1.4

2 3

编写目的 .......................................................................................................... 14 包含内容 .......................................................................................................... 14 读者对象 .......................................................................................................... 14 参考资料 .......................................................................................................... 14

软件模块标识 ............................................................................................................................ 14 基础类组件（ESB_COMMON） ........................................................................................... 16

3.1 3.2

3.2.1 3.2.2 3.2.3 3.2.4 3.2.5 3.2.6 3.2.7 3.2.8 3.2.9 3.2.10 3.2.11 3.2.12 3.2.13 3.2.14 3.2.15 3.2.16 3.2.17 3.2.18 3.2.19 3.2.20 3.2.21 3.2.22 3.2.23

功能描述 .......................................................................................................... 16 接口描述 .......................................................................................................... 16

数据对象的接口申明（adbc.esb.DataObject） ....................................................... 16

服务请求接口申明（adbc.esb.ServiceRequest） .................................................... 23 服务应答接口申明（adbc.esb.ServiceResponse） .................................................. 24 带错误码的异常类型接口申明（adbc.esb.ErrorCodedException） ..................... 24 服务过滤器接口申明（adbc.esb.ServiceFilter） ..................................................... 26 错误代码定义接口申明（adbc.esb. ErrorCodes） .................................................. 27 Http报文头信息接口申明（adbc.esb. EsbHttpHeaders） ................................... 31 消息处理器接口申明（adbc.esb. MessageProcessor） .......................................... 32 通知消息接口申明（adbc.esb. Notification） ......................................................... 35

服务信息接口申明（adbc.esb. ServiceMessage） .......................................... 35 根据表达式进行取值和赋值的接口定义（adbc.esb.util.ExpressionEvaluator）44

数字ID产生器（adbc.esb.util. NumberIdGenerator） ................................ 46 脚本命令执行接口(adbc.esb.util.ShellCommandExecutor) .......................... 46 基于SQL语句的数据访问接口(adbc.esb.util.SqlBasedDao) ........................ 47 字符串ID产生器(adbc.esb.util.StringIdGenerator) ...................................... 52 认证方式定义接口(adbc.esb. AuthMethods) .................................................. 52 异常处理模式(adbc.esb. ExceptionHandleMode) .......................................... 53 异常类型(adbc.esb. ExceptionType) ................................................................ 53 管理状态定义接口(adbc.esb. ManagementStatus) ......................................... 53 处理操作接口(adbc.esb. ProcessingAction) .................................................... 54 运行模式(adbc.esb. RunMode) ......................................................................... 54 运行状态类型(adbc.esb. RuntimeType) ........................................................... 55 工作状态定义接口(adbc.esb. WorkingStatus) ................................................. 55

3.3

3.3.1 类描述 .............................................................................................................. 56 数据对象的缺省实现（adbc.esb.DefaultDataObject） .......................................... 56

3.3.3 3.3.4 3.3.5 3.3.6 3.3.7 3.3.8 3.3.9 3.3.10 3.3.11 3.3.12 3.3.13 3.3.14 3.3.15 3.3.16 3.3.17 3.3.18 3.3.19 3.3.20 3.3.21 3.3.22 3.3.23 3.3.24 3.3.25 3.3.26 3.3.27 3.3.28 3.3.29 3.3.30 3.3.31 3.3.32

应用异常（adbc.esb.ApplicaitonException） ......................................................... 73 服务过滤器的抽象基类（adbc.esb.AbstractServiceFilter） .................................. 77 常量定义类（adbc.esb. Constants） ........................................................................ 79 消息处理器的缺省实现（adbc.esb. DefaultMessageProcessor） ......................... 81 通知消息的缺省实现（adbc.esb. DefaultNotification） ........................................ 89 服务信息的缺省实现（adbc.esb. DefaultServiceMessage） ................................. 90 服务请求的缺省实现（adbc.esb.DefaultServiceRequest） ................................. 101

服务应答的缺省实现（adbc.esb.DefaultServiceResponse） ...................... 102 ESB域值表（adbc.esb.EsbFieldTable） ........................................................ 103 完整性校验异常（adbc.esb. IntegrityCheckException） ............................ 105 无效消息异常（adbc.esb. InvalidMessageException） .............................. 106 应用不存在异常（adbc.esb. NoApplicationException） ............................ 107 应用系统会话不存在异常（adbc.esb. NoApplicationSessionException）108 通道不存在异常（adbc.esb. NoChannelException） .................................. 109 服务不存在异常（adbc.esb. NoServiceException） .................................... 111 服务上下文（adbc.esb. ServiceContext） ..................................................... 112 JNDI对象查找失败异常（adbc.esb.JndiObjectLookupException） ......... 119 名称服务上下文创建失败异常（adbc.esb. NamingContextCreateException）121

应用上下文帮助类（adbc.esb.util.ApplicationContextHelper） ............... 121 实体对象帮助类（adbc.esb.util.BeanHelper ） ........................................... 125 可以取得调用对象的执行任务

列表操作帮助类（adbc.esb.util.CollectionHelper ） .................................. 129 并发数据访问异常（adbc.esb.util.ConcurrentDataAccessException） .... 130 不正确的数据访问方式异常（adbc.esb.util.DataAccessUsageException）131

数据完整性检查异常（adbc.esb.util.DataIntegrityException） ................. 131 数据读取异常（adbc.esb.util.DataRetrievalException） ............................ 132 数据类型不匹配异常（adbc.esb.util.DataTypeMismatchException） ...... 133 日期帮助类（adbc.esb.util.DateHelper） ..................................................... 134 基于数据库的数字ID产生器（adbc.esb.util.DbBasedNumberIdGenerator）136

缺省的脚本命令执行器类（adbc.esb.util. DefaultShellCommandExecutor）140

（adbc.esb.util.CallableAwareFutureTask<V> ） ........................................................... 128

3.3.34 3.3.35 3.3.36 3.3.37 3.3.38 3.3.39 3.3.40 3.3.41 3.3.42 3.3.43 3.3.44 3.3.45 3.3.46 3.3.47 3.3.48 3.3.49 3.3.50 3.3.51 3.3.52 3.3.53 3.3.54 3.3.55 3.3.56 3.3.57 3.3.58 3.3.59 3.3.60 3.3.61

中文编码过滤器（adbc.esb.util.EncodingFilter） ........................................ 144 格式化数据帮助（adbc.esb.util.FormatHelper） ......................................... 146 格式化解析数据异常（adbc.esb.util.FormatParseException） .................. 147 基于Hibernate的数据访问对象基础类（adbc.esb.util.HibernateBasedDao）150

基于IBatis的SQL语句数据访问接口的实现

行处理代理器内部类（RowHandlerProxy） ................................................ 166 对消息进行日常操作的帮助类（adbc.esb.util.MessageHelper）............... 167 消息资源帮助类，用于根据代码取消息内容

基于OGNL实现的表达式取值、赋值帮助类（adbc.esb.util.OgnlEvaluator）175

可停止的多线程处理器（adbc.esb.util.PausableThreadPoolExecutor） .. 182 数据资源访问异常（adbc.esb.util.ResourceAccessException） ................ 185 资源清理异常（adbc.esb.util.ResourceCleanupException） ..................... 186 服务上下文帮助类(adbc.esb.util.ServiceContextHelper) ............................ 187 基于数据库的数字ID产生器(adbc.esb.util.TimeBasedNumberIdGenerator)188

未知的数据访问异常(adbc.esb.util.UnknownDataAccessException) ........ 189 根据表达式从对象中取值出现的异常(adbc.esb.util.ValueGetException) . 190 根据表达式赋值时出现的异常(adbc.esb.util.ValueSetException) .............. 193 文件异常(adbc.esb.util. FileException) .......................................................... 195 文件操作帮助类(adbc.esb.util. FileHelper) ................................................... 195 处理Fml32数据格式帮助类(adbc.esb.util. Fml32Helper) .......................... 197 基于字符串长度的比较(adbc.esb.util. LengthBasedComparator) .............. 204 随机UUID产生器(adbc.esb.util. RandomUUIDGenerator) ...................... 205 脚本命令执行异常(adbc.esb.util. ShellCommandException) ..................... 206 字符串帮助类(adbc.esb.util. StringHelper) ................................................... 207 异常帮助类(adbc.esb.util. ThrowableHelper) ............................................... 208 处理XML数据格式帮助类(adbc.esb.util. XmlHelper) ................................ 210 应用异常基类(adbc.esb. ApplicationException) ........................................... 211 无效参数异常(adbc.esb. InvalidArgumentException) ................................. 212

（adbc.esb.util.IBatisSqlBasedDao） .................................................................................. 158

（adbc.esb.util.MessageSourceHelper） ............................................................................ 173

3.4

3.4.1 视图描述 ........................................................................................................ 213 视图导航定义 ............................................................................................................. 213

4 消息转换组件（ESB_TRANSLATOR） ............................................................................ 213

4.1 4.2

4.2.2 4.2.3 4.2.4

功能描述 ........................................................................................................ 213 接口描述 ........................................................................................................ 213

213

消息转换器标准接口（adbc.esb.translator.message.MessageTranslator） ...... 214 文件转换服务标准接口（adbc.esb.translator. file.FileTranslationService） .... 215 文件转换器标准接口（adbc.esb.translator. file.FileTranslationService） ........ 216

4.2.1 消息转换服务标准接口（adbc.esb.translator.message.MessageTranslationService）

4.3

4.3.1 4.3.2 4.3.3 4.3.4 4.3.5 4.3.6 4.3.8 4.3.9 4.3.10 4.3.11 4.3.12

类描述 ............................................................................................................ 217

消息转换服务的缺省实现

FML32消息格式转换器（adbc.esb.translator. message.Fml32Translator） .... 220 XML消息格式转换器（adbc.esb.translator. message.XmlTranslator） ........... 228 ISO8583消息格式转换器（adbc.esb.translator. message.Iso8583Translator） 238 JavaObject消息格式转换器（adbc.esb.translator. message.JavaBeanTranslator）247

Json消息格式转换器（adbc.esb.translator. message.JsonTranslator） ............ 254 261

文件转换的配置信息（adbc.esb.translator. file.FileTranslationConfig） ......... 264 Json文件格式转换器（adbc.esb.translator.file.JsonFileTranslator） ................ 264

Xml文件格式转换器（adbc.esb.translator. file.XmlFileTranslator） ....... 267 找不到指定的消息转换器异常（adbc.esb.translator.

消息转换异常（adbc.esb.translator. message.TranslationException） .... 269

（adbc.esb.translator.message.DefaultMessageTranslationService） ............................ 217

4.3.7 文件转换服务的缺省实现（adbc.esb.translator. file.DefaultFileTranslationService）

message.NoTranslatorException） ..................................................................................... 268

5 数据安全组件（ESB_DATASECURITY） ........................................................................ 270

5.1 5.2

5.2.1 5.2.2 5.2.3 5.2.4 5.2.5 5.2.6

功能描述 ........................................................................................................ 270 接口描述 ........................................................................................................ 271

消息完整性校验器接口(adbc.esb.datasecurity.Digester) ..................................... 271

消息加解密器接口(adbc.esb.datasecurity.Encryptor) .......................................... 271 密钥生产器接口(adbc.esb.datasecurity.KeyGenerator) ....................................... 272 消息完整性检查服务接口(adbc.esb.datasecurity.MessageDigestService) ......... 273 消息加解密服务接口(adbc.esb.datasecurity.MessageEncryptionService) ........ 274 数字签名服务接口(adbc.esb.datasecurity.MessageSignService) ........................ 275

5.3

5.3.1

类描述 ............................................................................................................ 276

缺省的消息完整性检查服务的实现(adbc.esb.datasecurity.DefaultDigestService)276

5.3.3 5.3.4 5.3.5 5.3.6 5.3.7 5.3.8 5.3.9 5.3.10 5.3.11 5.3.12 5.3.13

SHA校验器(adbc.esb.datasecurity.SHADigester) ............................................... 279 CRC校验器(adbc.esb.datasecurity.CRCDigester) ............................................... 280 缺省的消息加解密服务的实现(adbc.esb.datasecurity.DefaultEncryptionService)281

DES算法的加密器(adbc.esb.datasecurity.DESEncryptor) .................................. 285 DES算法的密钥产生器(adbc.esb.datasecurity.DESKeyGenerator) ................... 286 解密失败异常(adbc.esb.datasecurity.EncryptionException) ............................... 288 数据校验失败异常(adbc.esb.datasecurity.DigestException) ............................... 289

校验器不存在异常(adbc.esb.datasecurity.NoDigesterException) .............. 290 加解密器不存在异常(adbc.esb.datasecurity.NoEncryptorException) ....... 291 密钥生成器不存在异常(adbc.esb.datasecurity.NoKeyGeneratorException)293

缺省的数字签名服务的实现

(adbc.esb.datasecurity.DefaultNumericSignService) ........................................................ 294

6 应用安全组件（ESB_APPSECURITY） ............................................................................ 295

6.1

6.2

6.2.1 6.2.2 6.2.3 6.2.4 6.2.5

功能描述 ........................................................................................................ 295 接口描述 ........................................................................................................ 295 应用系统访问控制服务接口（adbc.esb.appsecurity.AccessControlService） . 295

应用系统身份认证服务接口（adbc.esb.appsecurity.IdentityAuthService） .... 296 身份认证策略接口（adbc.esb.appsecurity.AuthAlgorithm） ............................ 297 服务请求拒绝原因定义接口（adbc.esb.appsecurity. AccessDeniedReason） . 297 心跳检查服务定义接口（adbc.esb.appsecurity.HeartCheckService） .............. 299

6.3

6.3.1 6.3.3 6.3.4 6.3.5 6.3.6 6.3.7 6.3.8 6.3.9 类描述 ............................................................................................................ 299 应用系统访问控制过滤器（adbc.esb.appsecurity.AccessControlFilter） ......... 299

301

缺省的应用系统身份认证实现

基于IP的身份认证策略（adbc.esb.appsecurity.IPAuthAlgorithm） .............. 315 基于证书的身份认证策略（adbc.esb.appsecurity.CertificateAuthAlgorithm）316

基于密码的身份认证策略（adbc.esb.appsecurity.PasswordAuthAlgorithm）318

空的身份认证策略（adbc.esb.appsecurity.NullAuthAlgorithm） .................... 319 服务请求被拒绝异常（adbc.esb.appsecurity.AccessDeniedException） ......... 319 应用系统未登记异常（adbc.esb.appsecurity.NoSuchApplicationException）321

6.3.2 服务列表的访问控制服务（adbc.esb.appsecurity.ServiceListBasedControlService）

（adbc.esb.appsecurity.DefaultIdentityAuthService） .................................................... 310

6.3.11 6.3.12 6.3.13 6.3.14 6.3.15

登录请求类（adbc.esb.appsecurity.LoginRequest）................................... 324 登录应答类（adbc.esb.appsecurity.LoginResponse） ................................ 326 缺省的心跳检测服务（adbc.esb.appsecurity. DefaultHeartCheckService）336

无效会话令牌异常（adbc.esb.appsecurity. InvalidSessionTokenException）337

无要求的认证策略异常（adbc.esb.appsecurity.NoAuthAlgorithmException）339

7 服务网关组件（ESB_GATEWAY） ................................................................................... 341

7.1

7.1.1 7.1.2 7.1.3

网关实现基类 ................................................................................................ 341 功能描述 ..................................................................................................................... 341

接口描述 ..................................................................................................................... 341 类描述 ......................................................................................................................... 342

7.2

7.2.1 7.2.2 7.2.3

TUXEDO网关 .............................................................................................. 347 功能描述 ..................................................................................................................... 347

接口描述 ..................................................................................................................... 347 类描述 ......................................................................................................................... 347

7.3

7.3.1 7.3.2 7.3.3

EJB网关 ......................................................................................................... 350 功能描述 ..................................................................................................................... 350

接口描述 ..................................................................................................................... 350 类描述 ......................................................................................................................... 351

7.4

7.4.1 7.4.2 7.4.3

MQ网关 ........................................................................................................ 353 功能描述 ..................................................................................................................... 353

接口描述 ..................................................................................................................... 353 类描述 ......................................................................................................................... 353

7.5

7.5.1 7.5.2 7.5.3

Web Service网关 ......................................................................................... 356 功能描述 ..................................................................................................................... 356

接口描述 ..................................................................................................................... 357 类描述 ......................................................................................................................... 357

7.6

7.6.1 7.6.2 7.6.3

HTTP网关..................................................................................................... 360 功能描述 ..................................................................................................................... 360

接口描述 ..................................................................................................................... 360 类描述 ......................................................................................................................... 360

7.7

7.7.1 7.7.2 TCP/IP网关 ................................................................................................. 365 功能描述 ..................................................................................................................... 365

接口描述 ..................................................................................................................... 365

7.7.3

类说明 ......................................................................................................................... 366

8 服务调度组件（ESB_ENGINE） ........................................................................................ 395

8.1 8.2

8.2.1 8.2.2 8.2.3 8.2.4 8.2.5 8.2.6 8.2.7 8.2.8

功能描述 ........................................................................................................ 395 接口描述 ........................................................................................................ 396 消息处理者的接口（adbc.esb.engine.MessageHandler） .................................. 396

服务分发器的接口（adbc.esb.engine.ServiceDispatcher）................................. 396 服务处理引擎接口（adbc.esb.engine.ServiceEngine） ....................................... 397 服务请求处理器接口（adbc.esb.engine.ServiceProcessor） ............................... 397 服务请求过滤器的接口（adbc.esb.engine.ServiceFilter） .................................. 398 服务处理者接口（adbc.esb.engine.ServiceHandler） ......................................... 399 负载均衡算法接口（adbc.esb.engine.LoadBalanceStrategy） ........................... 399 多线程服务执行器接口（adbc.esb.engine. ServiceExecutor） ........................... 400

8.3

8.3.1 8.3.2 8.3.3 8.3.4 8.3.5 8.3.6 8.3.7 8.3.8 8.3.9 8.3.10 8.3.11 8.3.12 8.3.13 8.3.14 8.3.15 8.3.16 8.3.17 8.3.18 8.3.19 8.3.20

类描述 ............................................................................................................ 401

通信回执处理者的实现（adbc.esb.engine. CommunicationMessageHandler）401

业务回执处理者的实现（adbc.esb.engine. ResponseMessageHandler） ......... 402 业务请求处理者的实现（adbc.esb.engine. RequestMessageHandler） ........... 404 服务分发器的缺省实现（adbc.esb.engine.DefaultServiceDispatcher） ........... 405 抽象服务处理引擎实现（adbc.esb.engine.AbstractServiceEngine） ................ 407 同步服务请求处理引擎（adbc.esb.engine.SyncRequestEngine） ...................... 411 异步服务请求处理引擎（adbc.esb.engine.AsyncRequestEngine） ................... 413 任务比较器(adbc.esb.engine.TaskComparator) .................................................... 415 异步服务请求处理Bean（adbc.esb.engine.AsyncRequestEngineBean） ......... 416

服务请求处理器缺省实现（adbc.esb.engine.DefaultServiceProcessor） . 419 服务处理者基类（adbc.esb.engine.AbstractServiceHandler） .................. 421 本地服务处理者（adbc.esb.engine.LocalServiceHandler） ....................... 422 远程服务处理者（adbc.esb.engine.RemoteServiceHandler） ................... 425 广播服务处理者（adbc.esb.engine. BroadcastServiceHandler） .............. 427 业务回执处理bean（adbc.esb.engine. MessageHandlerBean） ............... 429 多线程服务执行器的缺省实现（adbc.esb.engine. DefaultServiceExecutor）431

负载均衡算法缺省实现（adbc.esb.engine.DefaultLoadBalanceStrategy）437

服务处理任务（adbc.esb.engine. ServiceExecution） ................................. 440 服务执行取消异常（adbc.esb.engine. ExecutionCancelledException） ... 443 服务执行中断异常（adbc.esb.engine. ExecutionInterruptedException） 445

8.3.21 8.3.22 8.3.23 8.3.24 8.3.25 8.3.26 8.3.27 8.3.28 8.3.29 8.3.30 8.3.31

服务执行超时异常（adbc.esb.engine. ExecutionTimeoutException） ..... 446 无效前置平台流水号异常（adbc.esb.engine. InvalidEsbSnException） .. 447 无对应的应用服务名称异常（adbc.esb.engine. NoAppServiceException）448

无可用连接器异常（adbc.esb.engine. NoConnectorAvailableException）449

当前无服务提供者可供使用异常（adbc.esb.engine. 当前无服务访问者可供使用异常（adbc.esb.engine.

无服务处理者异常（adbc.esb.engine. RepeatMessageException） .......... 453 无服务处理引擎异常（adbc.esb.engine. NoServiceEngineException） ... 455 无服务处理者异常（adbc.esb.engine. NoServiceHandlerException） ..... 456 过滤器链定义静态内部类（adbc.esb.engine. DefaultServiceDispatcher. 过滤器入口静态内部类（adbc.esb.engine. DefaultServiceDispatcher.

NoProviderAvailableException） ....................................................................................... 451 NoVisitorAvailableException） ........................................................................................... 452

FilterChain） ........................................................................................................................... 457 FilterEntry） ........................................................................................................................... 460

9 业务日志组件（ESB_BIZLOG） ........................................................................................ 460

9.1

9.2

9.2.1 9.2.2

功能描述 ........................................................................................................ 460 接口描述 ........................................................................................................ 461 业务日志管理器接口（adbc.esb. bizlog. BusinessLogManager） ..................... 461

业务日志数据访问接口（adbc.esb. bizlog.dao.BusinessLogDao） ................... 463

9.3

9.3.1 9.3.2 9.3.3 9.3.4 9.3.5 9.3.6 9.3.7 9.3.8 9.3.9 9.3.10

类描述 ............................................................................................................ 465

业务日志管理器的缺省实现（adbc.esb. bizlog. DefaultBusinessLogManager）465

基于Hibernate的业务日志数据访问的实现

Esb业务日志实体类（log. BusinessLog） ....................................... 472 Esb报文日志实体类（log. MessageLog） ....................................... 473 不允许撤销异常（log. CancelNotAllowedException） ................. 474 服务处理冲突异常（log. ConflictProcessingException） .............. 475 业务日志不存在异常（log. NoBusinessLogException） ............... 477 请求未处理异常（log. NotYetProcessedException） ..................... 479 无对应的撤销服务代码异常（log. NoUndoServiceException） ... 480

撤销服务请求失败异常（log. UndoFailException） .............. 481

（log.dao.HibernateBusinessLogDao） ........................................................ 469

10 系统配置组件（ESB_CONFIG） ........................................................................................ 483

10.1 功能描述 ........................................................................................................ 483

10.2

接口描述 ........................................................................................................ 483

10.2.1 域管理接口(adbc.esb.config. ConfigManager) ............................................. 483

10.2.2 10.2.3 10.2.4 10.2.5 10.2.6

代码集服务层接口(adbc.esb.config. service.CodeSetService) ..................... 487 消息格式服务层接口(adbc.esb.config. service.MessageFormatService) ... 488 应用系统服务层接口（adbc.esb.config. service.ApplicationService） ..... 489 服务的服务层接口（adbc.esb.config. service.EsbServiceService） ........... 490 通道类型服务层接口（adbc.esb.config. service. ChannelTypeSerivce） . 491

10.3

类描述 ............................................................................................................ 493 10.3.1 域管理的实现类（adbc.esb.config. DefaultConfigManager） ................... 493

10.3.2 10.3.3 10.3.4 10.3.5 10.3.6 10.3.7

代码集服务层实现类（adbc.esb.config. service. DefaultCodeSetService）540

消息格式服务层实现类（adbc.esb.config. service.

应用系统服务层实现类（adbc.esb.config. service. DefaultApplicationService）547

服务的服务层实现类（adbc.esb.config. service. DefaultEsbServiceService）549

通道类型服务层实现类（adbc.esb.config. service.

无效代码异常（adbc.esb.config. InvalidCodeTypeException） ............... 553

DefaultMessageFormatService） ......................................................................................... 544

DefaultChannelTypeService） ............................................................................................. 551

11 运行监控组件（ESB_MONITOR） .................................................................................... 554

11.1 11.2

功能描述 ........................................................................................................ 554 接口描述 ........................................................................................................ 555

11.2.1 系统监控接口（adbc.esb.runtime.SystemMonitor） .................................. 555

11.2.2 11.2.3 11.2.4 11.2.5 11.2.6 11.2.7 11.2.8 11.2.9

服务请求监控接口（adbc.esb.runtime.ServiceRequestMonitor） ............ 572 工作负载记录器接口（adbc.esb.runtime.WorkloadRecorder） ................ 572 异常日志数据访问对象接口定义（adbc.esb.runtime.dao. ExceptionLogDao）573

运行状态信息数据访问对象接口定义（adbc.esb.runtime.dao. RuntimeDao）574

会话数据访问接口定义（adbc.esb.runtime.dao. SessionDao） ................. 576 历史工作负载数据访问对象接口定义（adbc.esb.runtime.dao. WorkloadDao）577

异常处理器接口定义（adbc.esb.runtime. ExceptionHandler） ................ 580 周期性系统运行工作状态记录（adbc.esb.runtime. SystemRuntimeRecorder）581

11.3 类描述 ............................................................................................................ 581

11.3.1 11.3.2 11.3.3 11.3.4 11.3.5 11.3.6 11.3.7 11.3.8 11.3.9 11.3.10 11.3.11 11.3.12 11.3.13 11.3.14 11.3.15 11.3.16 11.3.17 11.3.18 11.3.19 11.3.20

服务请求监控缺省实现类（adbc.esb.runtime.DefaultServiceRequestMonitor）581

周期性工作负载记录器实现类

系统异常日志（adbc.esb.runtime.model.ExceptionLog） ......................... 592 工作负载类（adbc.esb.runtime.model.Workload） .................................... 593 系统工作区实现（adbc.esb.runtime.WorkingArea） ................................. 594 基于HIBERNATE的异常日志数据访问对象的实现（adbc.esb.runtime.dao. 基于HIBERNATE的运行状况信息数据访问对象实现

基于HIBERNATE的会话信息数据访问对象实现（adbc.esb.runtime.dao. 基于HIBERNATE的系统负载历史信息数据访问接口实现

自动撤销异常处理器（adbc.esb.runtime. AutomaticUndoExceptionHandler）635

运行监控缺省实现（adbc.esb.runtime. DefaultSystemMonitor） ............ 636 触发事件异常处理器（adbc.esb.runtime. EventFireExceptionHandler） 665 异常事件（adbc.esb.runtime. ExceptionEvent） ......................................... 665 异常处理过滤器（adbc.esb.runtime. ExceptionHandlingFilter） ............. 669 异常侦听器（adbc.esb.runtime. ExceptionListener） ................................. 670 忽略异常处理器（adbc.esb.runtime. IgnoreExceptionHandler） ............. 672 记录异常日志异常事件处理器（adbc.esb.runtime. LogExceptionHandler）672

通知方式的异常处理（adbc.esb.runtime. NotifyExceptionHandler） ..... 674 周期性系统运行信息记录（adbc.esb.runtime.

检测服务提供者（adbc.esb.runtime. ProviderChecker） ........................... 680

（adbc.esb.runtime.PeriodicalWorkloadRecorder） ........................................................ 586

HibernateExceptionLogDao） ............................................................................................. 623 （adbc.esb.runtime.dao. HibernateRuntimeDao） ........................................................... 625 HibernateSessionDao） ......................................................................................................... 629 （adbc.esb.runtime.dao. HibernateWorkloadDao） ........................................................ 631

PeriodicalSystemRuntimeRecorder） ................................................................................. 676

11.4

12

与其他模块的依赖关系 ................................................................................ 680 功能描述 ........................................................................................................ 681

身份管理组件（ESB _IDM） ............................................................................................... 681

12.1 12.2

接口描述 ........................................................................................................ 681

12.2.1 用户库接口申明(erRepository) .......................................... 681

12.2.2 12.2.3 12.2.4

角色库接口申明(adbc.esb.idm.RoleRepository) ........................................... 683 资源库接口申明(adbc.esb.idm.ResourceRepository) ................................... 685 机构库接口申明(anizationRepository) ........................... 687

12.2.5 12.2.6 12.2.7 12.2.8 12.2.9 12.2.10

机构类型库接口申明(adbc.esb.idm. OrganizationTypeRepository) .......... 690 用户数据访问接口申明(erDao) ................................... 691 角色数据访问接口申明(adbc.esb.idm.dao.RoleDao) ................................... 693 资源数据访问对象接口申明(adbc.esb.idm.dao.ResourceDao) ................... 694 机构数据访问接口申明(anizationDao) .................... 695 机构类型数据访问接口申明(adbc.esb.idm.dao. OrganizationTypeDao) .. 696

12.3

类描述 ............................................................................................................ 697

12.3.1 用户库的缺省实现(adbc.esb.idm.DefaultUserRepository) ......................... 698

12.3.2 12.3.3 12.3.4 12.3.5 12.3.6 12.3.7 12.3.8 12.3.9 12.3.10 12.3.11 12.3.12 12.3.13 12.3.14 12.3.15

角色库的缺省实现(adbc.esb.idm.DefaultRoleRepository) .......................... 702 资源库的缺省实现(adbc.esb.idm.DefaultResourceRepository) .................. 706 机构库的缺省实现(adbc.esb.idm.DefaultOrganizationRepository) .......... 712 机构类型库的缺省实现(adbc.esb.idm. DefaultOrganizationTypeRepository)719

基于Hibernate的用户数据访问对象实现类基于Hibernate的角色数据访问对象实现类基于Hibernate的资源数据访问实现类基于Hibernate的机构数据访问实现类

基于Hibernate的机构类型数据访问实现类(adbc.esb.idm.dao.

登录类(adbc.esb.idm.servlet. doLogin) ......................................................... 733 退出类(adbc.esb.idm.servlet. doLogout) ....................................................... 734 无效认证密钥异常(ersecurity. InvalidUserCredentialException)736

无此用户异常(ersecurity. NoSuchUserException) ................... 737 实现MD5加密算法(adbc.esb.idm. MD5Encrypt) ....................................... 738

(adbc.esb.idm.dao.HibernateUserDao) ............................................................................... 724 (adbc.esb.idm.dao.HibernateRoleDao) ............................................................................... 727 (adbc.esb.idm.dao.HibernateResourceDao) ....................................................................... 728 (adbc.esb.idm.dao.HibernateOrganizationDao) ................................................................ 730 HibernateOrganizationTypeDao) ........................................................................................ 731

13 文件传输组件（ESB_ FILE_TRANSPORT） ................................................................... 739

13.1 13.2 13.3

13.3.2

功能描述 ........................................................................................................ 739

接口描述 ........................................................................................................ 739 13.2.1 FTP客户端连接服务接口(adbc.esb.fs.FileOperationService) ..................... 739 类描述 ............................................................................................................ 740 13.3.1 FTP客户端连接服务的实现(adbc.esb.fs.DefaultFileOperationService) .... 740

FTP服务端的实现（adbc.esb.ftp.FtpServerBean） ..................................... 741

1 引言

1.1 编写目的

编写该文档的目的在于从各组件设计的角度对综合前置系统的设计思想、工作原理、组成结构、各组成部分的主要功能及相互之间的关系做详细的说明，为后续程序编码及测试提供依据，为以后的系统维护和升级提供翔实准确的技术参考资料。

1.2 包含内容

以组件为单位详细说明综合前置系统的设计内容。

1.3 读者对象

综合前置系统全体成员

1.4 参考资料

2 软件模块标识

9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33

数据加解密组件 数据完整性校验组件 数字签名组件 应用安全组件 服务网关组件 HTTP 网关组件 WS 网关组件 TCP 网关组件 ATMI 网关组件 EJB 网关组件 MQ 网关组件 应用连接器组件 HTTP 连接器组件 WS 连接器组件 TCP 连接器组件 ATMI 连接器组件 EJB 连接器组件 MQ 连接器组件 服务调度组件 业务日志组件 文件传输组件 基础服务组件 系统配置组件 运行监控组件 用户访问控制组件

ESB_DATA_ENCRYPTION ESB_DATA_DIGEST ESB_DATA_SIGN ESB_APP_SECURITY ESB_GATEWAY ESB_HTTP_GATEWAY ESB_WS_GATEWAY ESB_TCP_GATEWAY ESB_ATMI_GATEWAY ESB_EJB_GATEWAY ESB_MQ_GATEWAY ESB_CONNECTOR ESB_HTTP_ CONNECTOR ESB_WS_ CONNECTOR ESB_TCP_ CONNECTOR ESB_ATMI_ CONNECTOR ESB_EJB_ CONNECTOR ESB_MQ_ CONNECTOR ESB_ENGINE ESB_BIZLOG ESB_FILE_TRANSPORT ESB_LOCAL_SERVICE ESB_CONFIG ESB_MONITOR ESB_IDM

3 基础类组件（ESB_COMMON）

3.1 功能描述

定义了综合前置系统中各部分组件需要用到的公共类。

3.2 接口描述

3.2.1 数据对象的接口申明（adbc.esb.DataObject）3.2.1.1 接口定义

数据对象的接口申明。

3.2.1.2 继承的接口

java.io.Serializable

3.2.1.3 对外提供的服务内容

public Map<String, ?> getProperties()

描述：取所有属性的值。 参数：无

返回：属性映射表，以属性名作为键值 异常：无

public void setProperties(Map<String, ?> properties);

描述：给属性赋值。 参数：properties 属性映射表 返回：无 异常：无

public Object get(String path)

描述：取给定属性的值 参数：path String 属性表达式 返回：Object属性值

异常：无

public BigDecimal getBigDecimal(String path)

描述：取给定大浮点类型的属性 参数：path String属性表达式 返回：属性值 异常：无。

public BigInteger getBigInteger(String path)

描述：取给定大整型类型的属性值。 参数：path String 属性表达式 返回：BigInteger类型属性值 异常：无。

public boolean getBoolean(String path)

描述：取给定布尔型的属性值 参数：path String 属性表达式 返回：属性值 异常：无。

public byte getByte(String path)

描述：取给定字节类型的属性值 参数：path String 属性表达式 返回：属性值 异常：无。

public byte[] getBytes(String path)

描述：取给定字节串类型的属性值 参数：path String 属性表达式 返回：属性值。 异常：无。

public char getChar(String path)

描述：取给定字符类型的属性值 参数：path String属性表达式

返回：属性值 异常：无。

public Date getDate(String path)

描述：取给定日期类型的属性值 参数：path String 属性表达式 返回：属性值 异常：无。

public double getDouble(String path)

描述：取给定双精度类型的属性 参数：path String 属性表达式 返回：属性值 异常：无。

public float getFloat(String path)

描述：取给定浮点类型的属性 参数：path String 属性表达式。 返回：属性值 异常：无。

public int getInt(String path)

描述：取给定整形类型的属性 参数：path String 属性表达式 返回：属性值。 异常：无。

public List getList(String path)

描述：取给定列表类型的属性 参数：path String 属性表达式 返回：属性值 异常：无。

public long getLong(String path)

描述：取给定长整数类型的属性

参数：path String 属性表达式 返回：long 属性值 异常：无。

public short getShort(String path)

描述：取给定短整数类型的属性 参数：path String 属性表达式 返回：属性值 异常：无。

public String getString(String path)

描述：取给定字符串类型的属性 参数：path String 属性表达式 返回：属性值 异常：无。

public boolean isSet(String path)

描述：判断给定属性是否被赋值 参数：path String 表达式 返回：boolean 是否被赋值 异常：无。

public void set(String path, Object value)

描述：对给定的属性赋值 参数：path String 表达式

value Object 值 返回：无。 异常：无。

public void setBigDecimal(String path, BigDecimal value)

描述：对给定的属性赋大浮点数。 参数：path String 表达式

value BigDecimal 值 返回：无。

public void setBigInteger(String path, BigInteger value)

描述：对给定的属性赋大整型数。 参数：path String 表达式

value BigInteger 值。

返回：无。 异常：无。

public void setBoolean(String path, boolean value)

描述：对给定的属性赋布尔值。 参数：path String 表达式

value boolean 值。 返回：无。 异常：无。

public void setByte(String path, byte value)

描述：对给定的属性赋字节值。 参数：path String 表达式

value byte 值。 返回：无。 异常：无。

public void setBytes(String path, byte[] value)

描述：对给定的属性赋字节串。 参数：path String 表达式

value byte[] 值。 返回：无。 异常：无。

public void setChar(String path, char value)

描述：对给定的属性赋字符值。 参数：path String 表达式

value char 值。

异常：无。

public void setDate(String path, Date value)

描述：对给定的属性赋日期值。 参数：path String 表达式

value Date 值。 返回：无。 异常：无。

public void setDouble(String path, double value)

描述：对给定的属性赋双精度浮点值。 参数：path String 表达式

value double值。 返回：无。 异常：无。

public void setFloat(String path, float value)

描述：对给定的属性赋浮点值。 参数：path String 表达式

value float 值。 返回：无。 异常：无。

public void setInt(String path, int value)

描述：对给定的属性赋整数值。 参数：path String 表达式

value int 值。 返回：无。 异常：无。

public void setList(String path, List value)

描述：对给定的属性赋列表值。 参数：path String 表达式

本文来源：https://www.bwwdw.com/article/tmz4.html