IBM BJ0NJML Integration Guide - Page 159

Handlers, Enterprise Bean Handler

Page 159 highlights

Handlers Handlers A handler specifies how to route outbound data to a specific endpoint location, in a specific format. Enterprise Bean Handler CONTEXTFACTORY Property EJBEXIT Property The Enterprise JavaBean (EJB) handler is a Java component that consists of enterprise bean clients. The handler publishes a set of properties that a client uses to communicate with the target. The handler delivers system messages to the enterprise bean client. The target client can run on the local application server or a remote application server. For the handler to establish a connection, the remote class and home class must be available in the class path of the handler. If the client is on a remote application server that is different from the handler application server, the client jar file reference must be in the class path of the handler. Conversely, the handler picks up the context factory class name from the local application server when the enterprise bean client is on a remote application server that is the same as the handler application server. This required property specifies a J2EE context factory class name. The documentation for your application server contains the name of the default context factory to use. The CONTEXTFACTORY uses the following property when the target client runs on an IBM WebSphere Application Server: com.ibm.websphere.naming.WsnInitialContextFactory This optional property is used for customization. This property specifies the fully qualified name of a custom Java class that implements the EJBExit interface. If you do not specify a value for this property, the default exit runs the DefaultEJBExit. The system then attempts to resolve the enterprise bean method signature and parameters. If the enterprise bean client has its own method signature and parameters, create a Java class that contains your version of the EJBExit interface and implementations of the following methods. public Class[] getClassParams() The getClassParams() method returns the method signature in the form of an array of Java classes. public Object[] getObjectParams(byte[] data, String interfaceName, Map String,? metaData)throws MXException The getObjectParams() method returns the parameters of the enterprise bean business method in the form of an array of Java objects. public void responseOk(Object response)throws MXException Endpoints and Handlers 145

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 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
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250
  • 251
  • 252
  • 253
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274
  • 275
  • 276
  • 277
  • 278
  • 279
  • 280
  • 281
  • 282
  • 283
  • 284
  • 285
  • 286
  • 287
  • 288
  • 289
  • 290
  • 291
  • 292
  • 293
  • 294
  • 295
  • 296
  • 297
  • 298
  • 299
  • 300
  • 301
  • 302
  • 303
  • 304
  • 305
  • 306
  • 307
  • 308
  • 309
  • 310
  • 311
  • 312
  • 313
  • 314
  • 315
  • 316
  • 317
  • 318
  • 319
  • 320
  • 321
  • 322
  • 323
  • 324
  • 325
  • 326
  • 327
  • 328
  • 329
  • 330

Handlers
Endpoints and Handlers
145
Handlers
A handler specifies how to route outbound data to a specific endpoint location, in
a specific format.
Enterprise Bean Handler
The Enterprise JavaBean (EJB) handler is a Java component that consists of
enterprise bean clients. The handler publishes a set of properties that a client uses
to communicate with the target. The handler delivers system messages to the
enterprise bean client. The target client can run on the local application server or a
remote application server.
For the handler to establish a connection, the remote class and home class must be
available in the class path of the handler. If the client is on a remote application
server that is different from the handler application server, the client jar file
reference must be in the class path of the handler.
Conversely, the handler picks up the context factory class name from the local
application server when the enterprise bean client is on a remote application
server that is the same as the handler application server.
CONTEXTFACTORY
Property
This required property specifies a J2EE context factory class name. The
documentation for your application server contains the name of the default
context factory to use.
The CONTEXTFACTORY uses the following property when the target client runs
on an IBM WebSphere Application Server:
com.ibm.websphere.naming.WsnInitialContextFactory
EJBEXIT Property
This optional property is used for customization. This property specifies the fully
qualified name of a custom Java class that implements the EJBExit interface.
If you do not specify a value for this property, the default exit runs the
DefaultEJBExit. The system then attempts to resolve the enterprise bean method
signature and parameters.
If the enterprise bean client has its own method signature and parameters, create
a Java class that contains your version of the EJBExit interface and
implementations of the following methods.
public Class[] getClassParams()
The getClassParams() method returns the method signature in the form of an
array of Java classes.
public Object[] getObjectParams(byte[] data, String
interfaceName, Map
String,?
metaData)throws MXException
The getObjectParams() method returns the parameters of the enterprise bean
business method in the form of an array of Java objects.
public void responseOk(Object response)throws MXException