← Back to branch summary

~ubuntu-branches/ubuntu/wily/libjboss-remoting-java/wily

« back to all changes in this revision

Viewing changes to docs/guide/en/chap1.xml

  • Committer: Package Import Robot
  • Author(s): Torsten Werner
  • Date: 2011-09-09 14:01:03 UTC
  • mfrom: (1.1.6 upstream)
  • Revision ID: package-import@ubuntu.com-20110909140103-hqokx61534tas9rg
Tags: 2.5.3.SP1-1
http://bugs.debian.org/628303
* Newer but not newest upstream release. Do not build samples.
* Change debian/watch to upstream's svn repo.
* Add patch to fix compile error caused by tomcat update.
  (Closes: #628303)
* Switch to source format 3.0.
* Switch to debhelper level 7.
* Remove useless Depends.
* Update Standards-Version: 3.9.2.
* Update README.source.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/guide/en/chap1.xml
 
1
<?xml version="1.0" encoding="UTF-8"?>
 
2
<chapter>
 
3
  <title>Overview</title>
 
4
 
 
5
  <section>
 
6
    <title>What is JBoss Remoting?</title>
 
7
 
 
8
    <para>The purpose of JBoss Remoting is to provide a single API for most
 
9
    network based invocations and related service that uses pluggable
 
10
    transports and data marshallers. The JBossRemoting API provides the
 
11
    ability for making synchronous and asynchronous remote calls, push and
 
12
    pull callbacks, and automatic discovery of remoting servers. The intention
 
13
    is to allow for the use of different transports to fit different needs,
 
14
    yet still maintain the same API for making the remote invocations and only
 
15
    requiring configuration changes, not code changes.</para>
 
16
 
 
17
    <para>JBossRemoting is a standalone project, separate from the JBoss
 
18
    Application Server project, but will be the framework used for many of the
 
19
    JBoss projects and components when making remote calls. JBossRemoting is
 
20
    included in the recent releases of the JBoss Application Server and can be
 
21
    run as a service within the container as well. Service configurations are
 
22
    included in the configuration section below.</para>
 
23
  </section>
 
24
 
 
25
  <section>
 
26
    <title>Features</title>
 
27
 
 
28
    <para>The features available with JBoss Remoting are:</para>
 
29
 
 
30
    <itemizedlist>
 
31
      <listitem>
 
32
        <para><emphasis role="bold">Server identification</emphasis> – a
 
33
        simple url based identifier which allows for remoting servers to be
 
34
        identified and called upon.</para>
 
35
      </listitem>
 
36
 
 
37
      <listitem>
 
38
        <para><emphasis role="bold">Pluggable transports</emphasis> – can use
 
39
        different protocol transports the same remoting API.</para>
 
40
 
 
41
        <para>Provided transports:</para>
 
42
 
 
43
        <itemizedlist>
 
44
          <listitem>
 
45
            <para>Socket (SSL Socket)</para>
 
46
          </listitem>
 
47
 
 
48
          <listitem>
 
49
            <para>RMI (SSL RMI)</para>
 
50
          </listitem>
 
51
 
 
52
          <listitem>
 
53
            <para>HTTP(S)</para>
 
54
          </listitem>
 
55
          
 
56
          <listitem>
 
57
            <para>Servlet (SSL Servlet)</para>
 
58
          </listitem>
 
59
 
 
60
          <listitem>
 
61
            <para>Bisocket (SSL Bisocket)</para>
 
62
          </listitem>
 
63
        </itemizedlist>
 
64
      </listitem>
 
65
 
 
66
      <listitem>
 
67
        <para><emphasis role="bold">Pluggable data marshallers</emphasis> –
 
68
        can use different data marshallers and unmarshallers to convert the
 
69
        invocation payloads into desired data format for wire transfer.</para>
 
70
      </listitem>
 
71
 
 
72
      <listitem>
 
73
        <para><emphasis role="bold">Pluggable serialization</emphasis> - can
 
74
        use different serialization implementations for data streams.</para>
 
75
 
 
76
        <para>Provided serialization implementations:</para>
 
77
 
 
78
        <itemizedlist>
 
79
          <listitem>
 
80
            <para>Java serialization</para>
 
81
          </listitem>
 
82
 
 
83
          <listitem>
 
84
            <para>JBoss serialization</para>
 
85
          </listitem>
 
86
        </itemizedlist>
 
87
      </listitem>
 
88
 
 
89
      <listitem>
 
90
        <para><emphasis role="bold">Automatic discovery</emphasis> – can
 
91
        detect remoting servers as they come on and off line.</para>
 
92
 
 
93
        <para>Provided detection implementations:</para>
 
94
 
 
95
        <itemizedlist>
 
96
          <listitem>
 
97
            <para>Multicast</para>
 
98
          </listitem>
 
99
 
 
100
          <listitem>
 
101
            <para>JNDI</para>
 
102
          </listitem>
 
103
        </itemizedlist>
 
104
      </listitem>
 
105
 
 
106
      <listitem>
 
107
        <para><emphasis role="bold">Server grouping</emphasis> – ability to
 
108
        group servers by logical domains, so only communicate with servers
 
109
        within specified domains.</para>
 
110
      </listitem>
 
111
 
 
112
      <listitem>
 
113
        <para><emphasis role="bold">Callbacks</emphasis> – can receive server
 
114
        callbacks via push and pull models. Pull model allows for persistent
 
115
        stores and memory management.</para>
 
116
      </listitem>
 
117
 
 
118
      <listitem>
 
119
        <para><emphasis role="bold">Asynchronous calls</emphasis> – can make
 
120
        asynchronous, or one way, calls to server.</para>
 
121
      </listitem>
 
122
 
 
123
      <listitem>
 
124
        <para><emphasis role="bold">Local invocation</emphasis> – if making an
 
125
        invocation on a remoting server that is within the same process space,
 
126
        remoting will automatically make this call by reference, to improve
 
127
        performance.</para>
 
128
      </listitem>
 
129
 
 
130
      <listitem>
 
131
        <para><emphasis role="bold">Remote classloading</emphasis> – allows
 
132
        for classes, such as custom marshallers, that do not exist within
 
133
        client to be loaded from server.</para>
 
134
      </listitem>
 
135
 
 
136
      <listitem>
 
137
        <para><emphasis role="bold">Sending of streams</emphasis> – allows for
 
138
        clients to send input streams to server, which can be read on demand
 
139
        on the server.</para>
 
140
      </listitem>
 
141
 
 
142
      <listitem>
 
143
        <para><emphasis role="bold">Clustering</emphasis> - seamless client
 
144
        failover for remote invocations.</para>
 
145
      </listitem>
 
146
 
 
147
      <listitem>
 
148
        <para><emphasis role="bold">Connection failure notification</emphasis>
 
149
        - notification if client or server has failed</para>
 
150
      </listitem>
 
151
 
 
152
      <listitem>
 
153
        <para><emphasis role="bold">Data Compression</emphasis> - can use
 
154
        compression marshaller and unmarshaller for compresssion of large
 
155
        payloads.</para>
 
156
      </listitem>
 
157
    </itemizedlist>
 
158
 
 
159
    <para>All the features within JBoss Remoting were created with ease of use
 
160
    and extensibility in mind. If you have a suggestion for a new feature or
 
161
    an improvement to a current feature, please log in our issue tracking
 
162
    system at <!--<link linkend="???">http://jira.jboss.com</link>--> <ulink
 
163
    url="http://jira.jboss.com">http://jira.jboss.com</ulink></para>
 
164
  </section>
 
165
 
 
166
  <section>
 
167
    <title>How to get JBoss Remoting</title>
 
168
 
 
169
    <para>The JBossRemoting distribution can be downloaded from <ulink
 
170
    url="http://www.jboss.org/jbossremoting/">
 
171
    http://www.jboss.org/jbossremoting/</ulink> . This distribution
 
172
    contains everything needed to run JBossRemoting stand alone. The
 
173
    distribution includes binaries, source, documentation, javadoc, and sample
 
174
    code.</para>
 
175
  </section>
 
176
 
 
177
  <section>
 
178
    <title>What's new in version 2.5?</title>
 
179
    
 
180
    <para>Version 2.5.0 represents the process of upgrading the jars with
 
181
    which Remoting is tested and shipped. In particular, the jars are now
 
182
    equivalent to the jars found in the JBoss Application Server version
 
183
    5.0.0.CR2 (as of 9/6/08, before its release). Changes to jbossweb (the JBoss
 
184
    version of Tomcat) have necessitated dropping the use of Apache Tomcat,
 
185
    which means that the "http" transport will no longer function with jdk 1.4.</para>
 
186
  
 
187
    <para>Other features of Remoting 2.5.0.GA should function with jdk 1.4.
 
188
    However, it is the policy of JBoss, a division of Red Hat, no longer to
 
189
    support jdk 1.4.</para>
 
190
 
 
191
    <section>
 
192
      <title>Release 2.5.3.SP1</title>
 
193
      <itemizedlist>
 
194
        <listitem>
 
195
           <para>Performance fix to avoid excessive calls to InetAddress.getLocalHost()</para>
 
196
        </listitem>
 
197
      </itemizedlist>
 
198
    </section>
 
199
    
 
200
    <section>
 
201
      <title>Release 2.5.3</title>
 
202
      <itemizedlist>
 
203
        <listitem>
 
204
           <para>Security update.  Calls to state changing methods  of
 
205
           <classname>org.jboss.remoting.InvokerRegistry</classname> require permission
 
206
           <code>java.lang.RuntimePermission("invokerRegistryUpdate")</code></para>
 
207
        </listitem>
 
208
      </itemizedlist>
 
209
    </section>
 
210
    
 
211
    <section>
 
212
      <title>Release 2.5.2.SP3</title>
 
213
      <itemizedlist>
 
214
        <listitem>
 
215
           <para>Multiple bug fixes.</para>
 
216
        </listitem>
 
217
      </itemizedlist>
 
218
    </section>
 
219
    
 
220
    <section>
 
221
      <title>Release 2.5.2.SP2</title>
 
222
      <itemizedlist>
 
223
        <listitem>
 
224
           <para>Multiple bug fixes.</para>
 
225
        </listitem>
 
226
      </itemizedlist>
 
227
    </section>
 
228
    
 
229
    <section>
 
230
      <title>Release 2.5.2</title>
 
231
      <itemizedlist>
 
232
        <listitem>
 
233
          <para>Introduction of "connection identity" concept</para>
 
234
        </listitem>
 
235
        <listitem><para>Introduction of write timeout facility;</para></listitem>
 
236
        <listitem><para>improved reliability for callbacks in bisocket transport;</para></listitem> 
 
237
        <listitem><para>improved treatment of invocation retries in socket and bisocket transports;</para></listitem>
 
238
        <listitem>
 
239
          <para>More flexible configuration (see, for example, <code>org.jboss.remoting.Remoting.CONFIG_OVERRIDES_LOCATOR</code>)</para>
 
240
        </listitem>
 
241
        <listitem>
 
242
          <para>Added immediate shutdown option for socket transport</para>
 
243
        </listitem>
 
244
        <!--listitem>
 
245
          <para>Jars updated to conform to Application Server 5.1.0.CR1</para>
 
246
        </listitem-->
 
247
        <listitem>
 
248
           <para>Multiple bug fixes.</para>
 
249
        </listitem>
 
250
      </itemizedlist>
 
251
    </section>
 
252
    
 
253
    <section>
 
254
      <title>Release 2.5.1</title>
 
255
      <itemizedlist>
 
256
        <listitem>
 
257
          <para>Security fix (JBREM-1116 "Remove SecurityUtility")</para>
 
258
        </listitem>
 
259
        <listitem>
 
260
          <para>More flexible configuration (see <code>org.jboss.remoting.Client.USE_ALL_PARAMS</code>)</para>
 
261
        </listitem>
 
262
        <listitem>
 
263
          <para>Jars updated to conform to Application Server 5.1.0.CR1</para>
 
264
        </listitem>
 
265
        <listitem>
 
266
           <para>Multiple bug fixes.</para>
 
267
        </listitem>
 
268
      </itemizedlist>
 
269
    </section>
 
270
    
 
271
    <section>
 
272
      <title>Release 2.5.0.SP2</title>
 
273
      <itemizedlist>
 
274
        <listitem>
 
275
           <para>A few bug fixes.</para>
 
276
        </listitem>
 
277
      </itemizedlist>
 
278
    </section>
 
279
        
 
280
    <section>
 
281
      <title>Release 2.5.0.SP1</title>
 
282
      
 
283
      <itemizedlist>
 
284
        <listitem>
 
285
           <para>The distribution zip file no longer contains previous versions of
 
286
           jboss-remoting.jar.</para>
 
287
        </listitem>
 
288
        
 
289
        <listitem>
 
290
           <para>A few bug fixes.</para>
 
291
        </listitem>
 
292
      </itemizedlist>
 
293
    </section>
 
294
    
 
295
  </section>
 
296
  
 
297
  <section>
 
298
    <title>What's new in version 2.4?</title>
 
299
 
 
300
    <section>
 
301
      <title>Release 2.4.0.SP2</title>
 
302
      
 
303
      <itemizedlist>
 
304
        <listitem>
 
305
          <para><classname>CoyoteInvoker</classname> adds the URL query to the
 
306
          <classname>InvocationRequest</classname> request map.</para>
 
307
        </listitem>
 
308
        
 
309
        <listitem>
 
310
          <para>A leak in Java serialization output marshalling has been fixed.</para>
 
311
        </listitem>
 
312
      </itemizedlist>
 
313
    </section>
 
314
    
 
315
    <section>
 
316
      <title>Release 2.4.0.SP1</title>
 
317
      
 
318
      <itemizedlist>
 
319
        <listitem>
 
320
          <para>The remote classloading facility can be configured with lists of
 
321
          classloaders.</para>
 
322
        </listitem>
 
323
        
 
324
        <listitem>
 
325
          <para>Classloading in the client can optionally start with the thread
 
326
         context classloader.</para>
 
327
        </listitem>
 
328
        
 
329
        <listitem>
 
330
          <para>Leasing can be enabled declaratively.</para>
 
331
        </listitem>
 
332
      </itemizedlist>
 
333
    </section>
 
334
    
 
335
    <section>
 
336
      <title>Release 2.4.0.GA</title>
 
337
      
 
338
      <para>JBossRemoting 2.4.0.GA is an incremental release, with dozens of bug
 
339
      fixes and several new features: </para>
 
340
      
 
341
      <itemizedlist>
 
342
        <listitem>
 
343
          <para>servers can be bound to multiple IP addresses</para>
 
344
        </listitem>
 
345
        <listitem>
 
346
          <para>can run in the presence of a security manager</para>
 
347
        </listitem>
 
348
        <listitem>
 
349
          <para>greater configurability</para>
 
350
        </listitem>
 
351
        <listitem>
 
352
          <para>supports IPv6 addresses</para>
 
353
        </listitem>
 
354
        <listitem>
 
355
          <para>improved connection monitoring</para>
 
356
        </listitem>
 
357
        <listitem>
 
358
          <para>server gets client address in invocations</para>
 
359
        </listitem>
 
360
        
 
361
      </itemizedlist>
 
362
    </section>
 
363
      
 
364
  </section>
 
365
</chapter>
 
 
b'\\ No newline at end of file'