Component Framework-Deploying

component service
R24

Information in this document is subject

to change without notice.
No part of this document may be
reproduced or transmitted in any form or
by any means, for any purpose, without
the express written permission of
TEMENOS HEADQUARTERS SA.
© 2022 Temenos Headquarters SA -
all rights reserved.
Component Framework Deploying component Service
Document History

Revisio
Date Amended Name Description
n
1 29th March 2020 Dhanya J Initial version
Basheer
2 12th April 2021 R21 AMR review
Ahamed

3 25th April 2022 M.Kumar R22 AMR review

4 6th April 2023 M.Kumar R23 AMR review

H. Sanofar
5 15th May 2023 Jdk11 Review
Nisha

H. Sanofar
6 6th March 2024 R24 AMR Review
Nisha

2 Temenos Application Framework Java – (TAFJ)

Component Framework Deploying component Service

Copyright

Copyright © Temenos Headquarters SA 2009-2024.

All rights reserved.
This document contains proprietary information that is protected by copyright. No part of this
document may be reproduced, transmitted, or made available directly or indirectly to a third party
without the express written agreement of TEMENOS UK Limited. Receipt of this material directly
TEMENOS UK Limited constitutes its express permission to copy. Permission to use or copy this
document expressly excludes modifying it for any purpose or using it to create a derivative
therefrom.

Errata and Comments

If you have any comments regarding this manual or wish to report any errors in the
documentation, please document them and send them to the address below:
Technology Department
Temenos Headquarters SA
2 Rue de l’Ecole-de-Chimie,
CH - 1205 Geneva,
Switzerland

Tel SB: +41 (0) 22 708 1150

Fax: +41 (0) 22 708 1160

Please include your name, company, address, and telephone and fax numbers, and email
address if applicable. [email protected]

3 Temenos Application Framework Java – (TAFJ)

Component Framework Deploying component Service

Table of Contents
Document History................................................................................................................... 2
Copyright................................................................................................................................ 3
Errata and Comments............................................................................................................. 3
Introduction............................................................................................................................. 5
Software Requirements........................................................................................................... 5
TAFJ Configuration................................................................................................................... 6
Overview for TAFJ....................................................................................................................... 6
API Deployment for TAFJ............................................................................................................ 7
jBC Deployment...................................................................................................................... 7
Java Deployment..................................................................................................................... 7
Provider Deployment.............................................................................................................. 8
Proxy Adaptor and Proxy Deployment....................................................................................8
Resources.................................................................................................................................. 9
Appendix............................................................................................................................... 10
Web Resources for J2EE Application Servers............................................................................10
jBoss 7.4............................................................................................................................ 10
Oracle WebLogic 14.0.0+.................................................................................................. 10
Oracle Glassfish 3.0.1........................................................................................................ 10
Properties File....................................................................................................................... 10

4 Temenos Application Framework Java – (TAFJ)

Component Framework Deploying component Service

Introduction
This section enables you to deploy different T24 Component Service APIs in Temenos Application Framework
(TAF) on supported platforms.

Software Requirements
This section provides you the details of the software required for deploying component services in Temenos
Application Framework (TAF) environment.

Requirement Description

T24 Component Service with its API

Available as part of runtime file.
packages (Release 12 or later)

TAFC runtime environment Applicable for TAFC deployment.

TAFJ runtime environment Applicable for TAFJ deployment.

JCA 1.5 compliant resource adapter that enables J2EE

tocfT24ra-ra.rar (TOCF(EE) T components to access T24 through jAgent. To know more, refer
24 resource adapter) to TAFC jAgent user guide. Applicable on J2EE application
server deployment for TAFC.

To download, go
Apache Axis2 – Release 1.8.2
to http://axis.apache.org/axis2/java/core/download.cgi

The supported servers are:

 IBM Web Sphere Liberty Application Server – Release

19.0.0.0+
J2EE compliant application server
 Oracle WebLogic – Release 14.0.0+

 JBoss – Release 7.4+

MS IIS Server 7 Applicable for .NET web service deployment for TAFC.

5 Temenos Application Framework Java – (TAFJ)

Component Framework Deploying component Service
TAFJ Configuration
This section explains the process to deploy APIs for TAFJ specific environment.

Overview for TAFJ

This section explains the deployment and configuration options that are available for TAFJ specific
environment.

NOTE: All component services depend on the libComponentFramework.jar library that is available in
the TAFJ_HOME\ext directory.

This is verified by using the below command.

C:\TAFJ\tShow GetServiceResponseHandler
Home : 'C:\TAFJ '
- Project : 'tafj' [ FOUND ]
BASIC source : 'C:\RTC\src\DEV\SoaFramework\build\tafj\basic\
GetServiceResponseHandler.b'
JAVA class :
'file:/C:/TAFJ/ext/tComponentFramework.jar!/com/temenos/t24/GetServiceRes
ponseHandler_21_cl.class'
Compiled the : 11 Oct 2011 16:19:18
on : hmll1010336
Timestamp : 1318346358797
Grammar : 1
Include Basic Replacement : false

T24 MB R12+ has all available component services by default in the T24_COMPONENTS directory.
Additionally, it provides extensions for existing component service, along with the native jBC API.

This section lists the artefacts in NEW_COMP_SRV\dist directory to deploy newly built component service
in T24 for TAFJ.

|_ JBCInsert[Contains JBCInserts which can be used by core T24

application to consume the service]
|_ lib[Contains all deployable artefacts]
|_ data[Contains component service data libraries]
|_ java[Contains Java data libraries]
|_ t24-<ComponentService>-Data.jar
|_ proxyAdaptor[Contains component service Proxy Adaptor to consume
external services]
|_ java[Contains Java libraries]
|_ t24-<ComponentService>-ProxyAdaptor.jar
|_ t24Service[Contains component service native and extended APIs]
|_ java[Contains Java libraries, Following JAR contains, jBC Impl, jBC,
Java and Proxy API]|_ t24-<ComponentService>.jar
|_ ws[Contains component service Provider (Web Service) API]
|_ java[Contains component service Java Provider API]
|_ t24-<ComponentService>-jws.aar

6 Temenos Application Framework Java – (TAFJ)

Component Framework Deploying component Service
API Deployment for TAFJ
This section explains the deployment process of jBC, Java, Provider, Proxy Adaptor and Proxy APIs in TAFJ.

jBC Deployment
This API enables applications and other components to access core component implementation within T24. It
is packaged in the T24-<ComponentService>.jar library in com.temenos.T24, which has jBC API
and jBC components for implementation.

EXAMPLE: T24-<CustomerService>.jar , T24-<ChargeService>.jar

Item Description

Existing Packaged within the T24 by default and is available

Component in T24_COMPONENTS directory.

New Component Available in the NEW_COMP_SRV\dist\lib\t24Service\java directory

as T24<ComponentService>.jar.

NOTE: You need to copy the library to T24_COMPONENTS or add the location in
Java CLASSPATH.

Deployment Verify the component deployment by applying jsh SJunejo ~ -->tShow

Verification <ComponentService>.<OperationName> command.

Dependencies Has core jBC routines and does not require deployment of other component
service artefacts.

Invoking jBC API Additional configurations are not required to use this library within T24, as API has
native code.

Java Deployment
This API provides access to T24 Component jBC implementation for third party system that is built in Java
language. Additionally, it convert core Java objects to jVar format and vice versa by providing standard Java
interface and objects to the third party. This helps to avoid the need to deal with internal T24 (jVar) format.

Java API is packaged in T24-<ComponentService>.jar library

in com.temenos.services.<ServiceName>, which has Java API, Java Impl, and Proxy API
components.

EXAMPLE: com.temenos.services.<Customer>, com.temenos.services.<Charge>

Item Description

Existing Packaged within T24 by default and is available in the T24_COMPONENTS directory.
Component

7 Temenos Application Framework Java – (TAFJ)

Component Framework Deploying component Service

Item Description

New Available in the NEW_COMP_SRV\dist\lib\t24Service\java directory

Component as T24<ComponentService>.jar.

NOTE: You can copy the library to T24_COMPONENTS or add the location in
Java CLASSPATH.

Dependencies Consists of core Java classes and depends on its lib-<ComponentService>-

Data.jar data library, which needs to be available in CLASSPATH.

NOTE: The library is available in the following directories:

 Existing component - Shipped by default within T24_COMPONENTS

 New component - Found in NEW_COMP_SRV\dist\lib\data\java

Invoking jBC You need to perform the following:

API
 Import T24-<ComponentService>.jar along with T24-
<ComponentSevrice>-Data.jar.

 Pass the T24environment properties (such as OFS_SOURCE to Java API) as

an argument while creating an object and calling the required operation.

NOTE: As each Java API instance represents the TAFJ jSession which is an expensive operation:

 Retain the object in your implementation for better performance.

 Reuse it by switching the context for a different user.

Provider Deployment
This API exposes T24 component jBC implementation as a web service. The following methods are used for
deploying Provider API of TAFC:

Deployment Method Server

Common Deployment Supported J2EE Application Server

Application Specific Server Deployment JBoss, IBM WebSphere

Proxy Adaptor and Proxy Deployment

Unlike jBC, Java, and Provider APIs whose core responsibility is to host T24 as data provider (that is, third
party system needs to access T24 and retrieve data by providing industry standard interfaces), the Proxy
Adaptor and API offer functionalities to access third party system within T24 (that is, making T24 a data
consumer). Additionally, it provides T24 component to switch from its default jBC implementation to standard
Java interface implementation on runtime, where you can write the custom code to access third party system.

8 Temenos Application Framework Java – (TAFJ)

Component Framework Deploying component Service
NOTE: Packaged in T24-<ComponentService>-proxyAdaptor.jar library, which is available in the
following directories:

 Existing component - COMPONENT_EXT\<ComponentName>\t24Proxy

 New component - NEW_COMP_SRV\dist\lib\proxyAdaptor\java

The Proxy Adaptor is deployed when the library is dropped in Java CLASSPATH, followed by adding or
updating the services.properties file in TAFJ_HOME/conf directory or from CLASSPATH. If jBC
API finds a request when checking the deployment, it redirects the request to Proxy Adaptor. On receiving the
request, it converts the format from native jVar to Java object, finds the proxy implementation by using
‘services.properties’ and forwards it to Java API and vice versa.

NOTE: You need to write the custom Java implementation of the

interface <ComponentService>ProxyAPI in T244-<ComponentService>.jar of com.temenos.serv
ices.<ComponentName> package and make it available in Java CLASSPATH.

The Proxy API has interface header files in the following directories:

 Existing component - T24_COMPONENTS

 New component - NEW_COMP_SRV\dist\t24Service/java along with the Java API

You need to replace <ComponentService> with the name of the component. For example,
CustomerService, ChargeService etc.

Resources
This section provides you additional information on Temenos Application Framework (TAF).

 Java JDK

 J2EE Connector Architecture (JCA) Specification

 JBoss

 Oracle Weblogic

 IBM Websphere Liberty Application Server

 Oracle Glassfish

Appendix
This section provides examples that helps you to understand API deployment for Temenos Application
Framework (TAF).

9 Temenos Application Framework Java – (TAFJ)

Component Framework Deploying component Service
Web Resources for J2EE Application Servers
jBoss 7.4
jca/t24ConnectionFactory com.jbase.jremote.JConnectionFactory
java:jca/t24ConnectionFactory

IBM WebSphere Liberty Application Server 19.0.0.0+

Oracle WebLogic 14.0.0+

jca/t24ConnectionFactory jca/t24ConnectionFactory

Oracle Glassfish 3.0.1

/axis2 jca/t24ConnectionFactory jca/t24ConnectionFactory

Properties File
Services.Properties

#########################################################################
##############
# This file will be loaded by Proxy Adaptor to find the Proxy Impl class.
# Example:
CustomerService=com.temenos.services.customer.CustomerServiceProxyImpl
#
# Add your entries below
#########################################################################
##############
#
<ComponentName>Service=<Fully_Qualified_ProxyImpl_Class_Name>

10 Temenos Application Framework Java – (TAFJ)