forked from apache/netbeans
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathapichanges.xml
1620 lines (1571 loc) · 79.7 KB
/
apichanges.xml
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
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<?xml version="1.0" encoding="UTF-8"?>
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
-->
<?xml-stylesheet type="text/xml" href="../nbbuild/javadoctools/apichanges.xsl"?>
<!DOCTYPE apichanges PUBLIC "-//NetBeans//DTD API changes list 1.0//EN" "../nbbuild/javadoctools/apichanges.dtd">
<!--
INFO FOR PEOPLE ADDING CHANGES:
Check the DTD (apichanges.dtd) for details on the syntax. You do not
need to regenerate the HTML, as this is part of Javadoc generation; just
change the XML. Rough syntax of a change (several parts optional):
<change>
<api name="compiler"/>
<summary>Some brief description here, can use <b>XHTML</b></summary>
<version major="1" minor="99"/>
<date day="13" month="6" year="2001"/>
<author login="jrhacker"/>
<compatibility addition="yes"/>
<description>
The main description of the change here.
Again can use full <b>XHTML</b> as needed.
</description>
<class package="org.openide.compiler" name="DoWhatIWantCompiler"/>
<issue number="14309"/>
</change>
Also permitted elements: <package>, <branch>. <version> is API spec
version, recommended for all new changes. <compatibility> should say
if things were added/modified/deprecated/etc. and give all information
related to upgrading old code. List affected top-level classes and
link to issue numbers if applicable. See the DTD for more details.
Changes need not be in any particular order, they are sorted in various
ways by the stylesheet anyway.
Dates are assumed to mean "on the trunk". If you *also* make the same
change on a stabilization branch, use the <branch> tag to indicate this
and explain why the change was made on a branch in the <description>.
Please only change this file on the trunk! Rather: you can change it
on branches if you want, but these changes will be ignored; only the
trunk version of this file is important.
Deprecations do not count as incompatible, assuming that code using the
deprecated calls continues to see their documented behavior. But do
specify deprecation="yes" in <compatibility>.
This file is not a replacement for Javadoc: it is intended to list changes,
not describe the complete current behavior, for which ordinary documentation
is the proper place.
-->
<apichanges>
<!-- First, a list of API names you may use: -->
<apidefs>
<apidef name="j2eeserver">J2EE Server API</apidef>
<!-- org.netbeans.modules.j2ee.deployment.plugins -->
<apidef name="plugins">Server Integration Plugin API</apidef>
<!-- org.netbeans.modules.j2ee.deployment.devmodules -->
<apidef name="devmodules">J2EE Module Development API</apidef>
<!-- org.netbeans.modules.j2ee.deployment.common -->
<apidef name="common">J2EE Server Common API</apidef>
<!-- org.netbeans.modules.j2ee.deployment.profiler -->
<apidef name="profiler">J2EE Server Common API</apidef>
<!-- org.netbeans.modules.j2ee.deployment.plugins.spi.support -->
<apidef name="support">Server Integration Plugin SPI Support</apidef>
</apidefs>
<!-- ACTUAL CHANGES BEGIN HERE: -->
<changes>
<change id="profileAndDebuggingInfo">
<api name="devmodules"/>
<summary>
Public API to ask the server about profile and debug support.
</summary>
<version major="1" minor="103"/>
<date day="21" month="8" year="2013"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Provides additional methods to query for support for debugging and profiling.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="ServerInstance"/>
<issue number="202587"/>
</change>
<change id="beforeDeploymentHook">
<api name="devmodules"/>
<summary>
Provide a way to execute custom code just before actual deployment.
</summary>
<version major="1" minor="102"/>
<date day="16" month="8" year="2013"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Additional Callable parameter allows execution of
custom code just before the actual deployment.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="Deployment"/>
<issue number="234194"/>
</change>
<!-- not used for 7.3
<change id="deployOnSaveListeners">
<api name="devmodules"/>
<summary>
Allows listening for deploy on save operations.
</summary>
<version major="1" minor="91"/>
<date day="1" month="2" year="2012"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Client can add/remove listeners which will be notified on
deploy on save event.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
<issue number="207724"/>
</change> -->
<change id="commonServerBridge">
<api name="j2eeserver"/>
<summary>
Added CommonServerBridge utility class to provide mapping of
instance url to common api server instance.
</summary>
<version major="1" minor="88"/>
<date day="13" month="1" year="2012"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Added CommonServerBridge utility class to provide mapping of
instance url to common api server instance.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="CommonServerBridge"/>
</change>
<change id="nonPersistentServer">
<api name="j2eeserver"/>
<summary>
Adds helper method to create server instance which is not persistent.
</summary>
<version major="1" minor="83"/>
<date day="24" month="8" year="2011"/>
<author login="dkonecny"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Adds helper method to create server instance which is not persistent.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="InstanceProperties"/>
</change>
<change id="allowInstanceSpecificModuleConfiguration">
<api name="plugins"/>
<summary>
Adds ModuleConfigurationFactory2 which can use the knowledge
of the server instance id to create the ModuleConfiguration.
</summary>
<version major="1" minor="74"/>
<date day="20" month="12" year="2010"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
The ModuleConfiguration2 enhance the old ModuleConfiguration
with new method to which the server instance id is passed
in addition to J2eeModule. The creation code can be more
instance specific.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="ModuleConfigurationFactory2"/>
<issue number="193255"/>
</change>
<change id="disableDeployOnSave">
<api name="plugins"/>
<summary>
Method to disable Deploy part of Deploy on Save and performing only
Compile on Save.
</summary>
<version major="1" minor="73"/>
<date day="19" month="11" year="2010"/>
<author login="dkonecny"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
In order to support JRebel and similar technologies it is
desirable to be able to turn on Compile on Save but disable
Deploy on Save. That is achieved by newly introduced method.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
<issue number="188361"/>
</change>
<change id="platformRoots">
<api name="plugins"/>
<summary>
Methods to obtain server, domain and middleware home.
</summary>
<version major="1" minor="72"/>
<date day="27" month="10" year="2010"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
So far there was just J2eePlatform.getPlatformRoots() with unclear
semantics. Now there are explicit getServerHome(), getDomainHome()
and getMiddlewareHome() methods in the API. The corresponding SPI
has been added - J2eePlatformImpl2.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="J2eePlatformImpl2"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="J2eePlatform"/>
<issue number="190387"/>
</change>
<change id="required-librariers">
<api name="plugins"/>
<summary>
Implement support for deployment of standalone EE modules.
</summary>
<version major="1" minor="70"/>
<date day="2" month="8" year="2010"/>
<author login="dkonecny"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Implemented both SPI and API for communication of requires libraries
from EE module to deployment server.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="DeploymentContext"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="DeploymentManager2"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="IncrementalDeployment2"/>
<issue number="186331"/>
</change>
<change id="deploymentDescriptorConfiguration">
<api name="j2eeserver"/>
<summary>
Added SPI interface through which plugin may indicate it requires
deployment descriptor.
</summary>
<version major="1" minor="69"/>
<date day="28" month="7" year="2010"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
The SPI interface DeploymentDescriptorConfiguration may be
implemented by the server plugin in order to indicate the
server needs deployment descriptor.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="DeploymentDescriptorConfiguration"/>
<issue number="189012"/>
</change>
<change id="serverLibraries">
<summary>
Implemented support for handling the server libraries.
</summary>
<version major="1" minor="68"/>
<date day="9" month="6" year="2010"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Implemented both SPI and API to provide support for server
libraries management.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.common.api" name="Version"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="ServerInstance"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="ServerLibrary"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="ServerLibraryDependency"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="OptionalDeploymentManagerFactory"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="ServerLibraryFactory"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="ServerLibraryImplementation"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="ServerLibraryManager"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="ServerLibraryConfiguration"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.support" name="ProxyOptionalFactory"/>
<issue number="182282"/>
</change>
<change id="optionalFactoryProxy">
<api name="support"/>
<summary>
Added class proxying the OptionalDeploymentManagerFactory and adding
the optional noInitializationFinish attribute.
</summary>
<version major="1" minor="66"/>
<date day="25" month="2" year="2010"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Added class ProxyOptionalFactory which delegates all calls
to configured delegate. Via noInitializationFinish it
is possible to supress finishInitialization() method when
it is not required by the plugin.
</p>
<p>
Designed to be used from XML Layer.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.support" name="ProxyOptionalFactory"/>
<issue number="180893"/>
</change>
<change id="deploymentFactoryProxy">
<api name="support"/>
<summary>
Added class proxying the DeploymentFactory and adding
the optional urlPattern attribute.
</summary>
<version major="1" minor="65"/>
<date day="22" month="2" year="2010"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Added class ProxyDeploymentFactory which delegates all calls
to configured delegate. Via urlPattern it is possible to do
precheck of server instance uri. The uri has to mach the pattern
otherwise the instance is rejected as not supported but
the factory.
</p>
<p>
Designed to be used from XML Layer.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.support" name="ProxyDeploymentFactory"/>
<issue number="148177"/>
</change>
<change id="resourceChangeReporter">
<api name="devmodules"/>
<summary>
Added API/SPI for signalling change in resources deployed to
server (via DeploymentChangeDescriptor).
</summary>
<version major="1" minor="63"/>
<date day="10" month="11" year="2009"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Added API/SPI to check for changes in resources deployed to
server. Such changes are flagged in DeploymentChangeDescriptor
and delivered to server plugin.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="ResourceChangeReporter"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="ResourceChangeReporterFactory"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="ResourceChangeReporterImplementation"/>
<issue number="175539"/>
</change>
<change id="filter">
<api name="devmodules"/>
<summary>
DeployOnSaveClassInterceptor added.
</summary>
<version major="1" minor="56"/>
<date day="15" month="5" year="2009"/>
<author login="mkleint"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
DeployOnSaveClassInterceptor class added + gettter in J2eeModuleProvider.
to allow processing Artifact instances coming from java infrastructure.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
<issue number="165045"/>
</change>
<change id="undeploy">
<api name="devmodules"/>
<summary>
Programmatic undeploy for the project.
</summary>
<version major="1" minor="52"/>
<date day="15" month="9" year="2008"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Provides a way to programmatic undeploy of the deployed app
(project represented by J2eeModuleProvider).
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="Deployment"/>
<issue number="83122"/>
</change>
<change id="finishServerInitialization">
<api name="plugins"/>
<summary>
Provide a way for a plugin to perform post initialization action.
</summary>
<version major="1" minor="51"/>
<date day="31" month="7" year="2008"/>
<author login="vkraemer"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
OptionalDeploymentManagerFactory gets a new stub, that plugin
implementations would override. The Plugin author can assume
that the ServerRegistry is initialized to the point where it
can support the creation on instances.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="OptionalDeploymentManagerFactory"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="ServerInitializationException"/>
<issue number="141427"/>
</change>
<change id="lookupProvider">
<api name="plugins"/>
<summary>
LookupProvider support for J2eePlatform lookup.
</summary>
<version major="1" minor="50"/>
<date day="23" month="7" year="2008"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Server plugins will use this static method in J2eePlatformImpl.getLookup()
method to enable registration of additional Lookup Providers in layer.xml files.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="LookupProvider"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.support" name="LookupProviderSupport"/>
<issue number="140219"/>
</change>
<change id="deployOnSaveAPI">
<api name="plugins"/>
<summary>
Provide a way for project to figure out whether deploy on save
is supported.
</summary>
<version major="1" minor="49"/>
<date day="15" month="7" year="2008"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Server instance class provides method isDeployOnSaveSupported
in order to fugure out whether deploy on save is supported.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="ServerInstance"/>
<issue number="138476"/>
</change>
<change id="deployOnSaveSPI">
<api name="plugins"/>
<summary>
Support methods to allow plugin to implement deploy on save.
</summary>
<version major="1" minor="47"/>
<date day="4" month="7" year="2008"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
SPI is enhanced by two methods isDeployOnSaveSupported and
deployOnSave in order to allow plugin to provide deploy on
save functionality.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="IncrementalDeployment"/>
<issue number="138476"/>
</change>
<change id="deploymentChangeDescriptor">
<api name="plugins"/>
<summary>
Added final class describing the changes during the incremental deployment.
</summary>
<version major="1" minor="47"/>
<date day="4" month="7" year="2008"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Added final class describing the changes during the incremental deployment.
New class DeploymentChangeDescriptor implements old interface (AppChangeDescriptor)
and should be used in any new API.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="DeploymentChangeDescriptor"/>
<issue number="138476"/>
</change>
<change id="serverInstanceDescriptor">
<api name="plugins"/>
<summary>
API providing information about server host, port and flag
indicating local installation.
</summary>
<version major="1" minor="46"/>
<date day="30" month="5" year="2008"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
API for querying server host, port and flag indicating
local installation. This is replacement for terrible hacks
querying (leaking) InstanceProperties directly.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="ServerInstanceDescriptor"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="ServerInstance"/>
<issue number="133751"/>
</change>
<change id="serverInstanceAPI">
<api name="plugins"/>
<summary>
There should be server instance representation in the API.
</summary>
<version major="1" minor="45"/>
<date day="29" month="5" year="2008"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
API server instance in the API with clear indication that
instance was removed should be used in favor of Deployment
facade.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="Deployment"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="InstanceRemovedException"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="ServerInstance"/>
<issue number="135324"/>
</change>
<change id="j2eePlatformLookup">
<api name="plugins"/>
<summary>
Add Lookup to J2eePlatformImpl to make it extensible.
</summary>
<version major="1" minor="44"/>
<date day="6" month="5" year="2008"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
J2eePlatform should provide Lookup containing support for
other technologies the server can provide (such as web services).
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="J2eePlatform"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="J2eePlatformImpl"/>
<issue number="133853"/>
</change>
<change id="removeDefaultServerAPI">
<api name="j2eeserver"/>
<summary>
Default server API residues removed.
</summary>
<version major="1" minor="42"/>
<date day="17" month="4" year="2008"/>
<author login="phejl"/>
<compatibility binary="incompatible" source="incompatible" semantic="incompatible"/>
<description>
<p>
In the past, before the J2EE support was added to NetBeans the default server
concept had been used. This concept was then abandoned since it did not work
anymore. The problem could occur for example if the default server was Tomcat
then the EJB project which was set to use the default server could not be
deployed to it, etc.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="Deployment"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="InstanceListener"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="InstanceProperties"/>
<issue number="83934"/>
</change>
<change id="removeInstance">
<api name="j2eeserver"/>
<summary>
Provides a way to remove server without need to invoke UI action.
</summary>
<version major="1" minor="41"/>
<date day="5" month="3" year="2008"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Method provides a way to remove server instance for plugins
which don't use the j2eeserver UI.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="InstanceProperties"/>
</change>
<change id="createLibrary">
<api name="plugins"/>
<summary>
Method that creates the library based on content of the platform.
</summary>
<version major="1" minor="40"/>
<date day="21" month="2" year="2008"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Methods allows creation of the library form the platform all
required files are copied to the new location. Requirement
introduced by java ee sharability.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="J2eePlatform"/>
</change>
<change id="isCommonUIRequired">
<api name="j2eeserver"/>
<summary>
OptionalDeploymentManagerFactory declares whether j2eeserver
should provide common UI (like wizard for example).
</summary>
<version major="1" minor="38"/>
<date day="1" month="2" year="2008"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
OptionalDeploymentManagerFactory declares whether j2eeserver
should provide common UI (like wizard for example). This
should be done with Common Server API for every new plugin.
InstantiatingIterator from OptionalDeploymentManagerFactory
will serve only to j2eeserver specific purposes if
isCommonUIRequired will return the false (the true is the default).
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="OptionalDeploymentManagerFactory"/>
<issue number="126010"/>
</change>
<change id="createInstancePropertiesWithoutUI">
<api name="j2eeserver"/>
<summary>
Provides a way how can plugin register instance to j2eeserver
without any UI.
</summary>
<version major="1" minor="37"/>
<date day="11" month="1" year="2008"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Provides a way how can plugin register instance to j2eeserver
without any UI. SPI provided by Common Server should be used
for UI integration.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="InstanceProperties"/>
<issue number="122885"/>
</change>
<change id="fixedProfilerAPIConstants">
<api name="profiler"/>
<summary>
Fixing state constants to be real (final) constants.
</summary>
<version major="1" minor="36"/>
<date day="11" month="12" year="2007"/>
<author login="phejl"/>
<compatibility binary="incompatible" source="incompatible" semantic="incompatible" addition="no"/>
<description>
<p>
State constants used in the profiler API were not constants
in real - they were just public static variables. This change
makes them final.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.profiler.api" name="ProfilerSupport"/>
<issue number="122430"/>
</change>
<change id="createInstanceProperties">
<api name="j2eeserver"/>
<summary>
Adding InstanceProperties.createInstanceProperties(String, String,
String, String, Map<String, String>) method.
</summary>
<version major="1" minor="35"/>
<date day="27" month="11" year="2007"/>
<author login="phejl"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
The InstanceProperties.createInstanceProperties(String, String, String, String)
method does not provide any way how to pass other initial properties
required by the plugin. This is usually needed and workarounded
in many plugins. New method provides additional parameter containing
the any plugin required properties.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="InstanceProperties"/>
<issue number="120379"/>
</change>
<change id="findJndiNameForEjb2">
<api name="j2eeserver"/>
<summary>
Adding J2eeModuleProvider.findJndiNameForEjb method.
</summary>
<version major="1" minor="33"/>
<date day="29" month="8" year="2007"/>
<author login="sherold"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
The J2eeModuleProvider.bindEjbReference and J2eeModuleProvider.bindEjbReferenceForEjb methods
need to pass an EJB JNDI name instead of EJB name to the plugin. The new J2eeModuleProvider.findJndiNameForEjb
method will allow to obtain the EJB JNDI name.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
<issue number="108198"/>
</change>
<change id="isRunning">
<api name="j2eeserver"/>
<summary>
Adding Deployment.isRunning() method.
</summary>
<version major="1" minor="32"/>
<date day="29" month="8" year="2007"/>
<author login="sherold"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Adding a method which will tell whether the given server is running or not.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="Deployment"/>
<issue number="113023"/>
</change>
<change id="findJndiNameForEjb">
<api name="j2eeserver"/>
<summary>
Adding EjbResourceConfiguration.findJndiNameForEjb method.
</summary>
<version major="1" minor="31"/>
<date day="26" month="7" year="2007"/>
<author login="sherold"/>
<compatibility binary="incompatible" source="incompatible" semantic="incompatible" addition="yes"/>
<description>
<p>
The EjbResourceConfiguration.bindEjbReference and EjbResourceConfiguration.bindEjbReferenceForEjb methods
need to pass an EJB JNDI name instead of EJB name to the plugin. The new EjbResourceConfiguration.findJndiNameForEjb
method will allow to obtain the EJB JNDI name.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="EjbResourceConfiguration"/>
<issue number="108198"/>
</change>
<change id="setCMPResource">
<api name="j2eeserver"/>
<summary>
Replacing ensureResourceDefinedForEjb with setCMPResource.
</summary>
<version major="1" minor="30"/>
<date day="15" month="6" year="2007"/>
<author login="sherold"/>
<compatibility binary="incompatible" source="incompatible" semantic="incompatible" addition="yes"/>
<description>
<p>
Removing J2eeModuleProvider.ConfigSupport.ensureResourceDefinedForEjb and
EjbResourceConfiguration.ensureResourceDefined methods and replacing them
with J2eeModuleProvider.ConfigSupport.setCMPResource and MappingConfiguration.setCMPResource.
</p>
<p>
The main reason for this change is that the ComponentInterface parameter can
no longer be used since the metadata model was introduced, other reason is that
the old name was confusing.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="EjbResourceConfiguration"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="MappingConfiguration"/>
<issue number="99217"/>
</change>
<change id="MetadataModel">
<api name="j2eeserver"/>
<summary>
Renaming getDeploymentDescriptor to getMetadataModel.
</summary>
<version major="1" minor="29"/>
<date day="12" month="6" year="2007"/>
<author login="sherold"/>
<compatibility binary="incompatible" source="incompatible" semantic="incompatible" addition="yes"/>
<description>
<p>
Renaming J2eeModule's and J2eeModuleImplementation's getDeploymentDescriptor method to getMetadataModel.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="J2eeModule"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleImplementation"/>
<issue number="99217"/>
</change>
<change id="AddServerWizard">
<api name="j2eeserver"/>
<summary>
Adds a method for displaying the Add server instance wizard.
</summary>
<version major="1" minor="28"/>
<date day="7" month="6" year="2007"/>
<author login="sherold"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Adds a method for displaying the Add server instance wizard.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="ServerManager"/>
<issue number="105403"/>
</change>
<change id="ExposeFileDeploymentCapabilityToProjects">
<api name="j2eeserver"/>
<summary>
Add a method that will allow Java EE project to determine if
they are being targeted at a server which will support directory-
based deployment.
</summary>
<version major="1" minor="27"/>
<date day="8" month="5" year="2007"/>
<author login="vkraemer"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Expose the directory deployment capabilities that a target server may
have which would allow the build script for a project to be
optimized to delay or eliminate unnecessary steps
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="Deployment"/>
<issue number="89439"/>
</change>
<change id="ResourceApiRedesignCallEjbAction">
<api name="j2eeserver"/>
<summary>
Adding an API for Call EJB action
</summary>
<version major="1" minor="26"/>
<date day="15" month="4" year="2007"/>
<author login="lkotouc"/>
<compatibility binary="incompatible" source="incompatible" semantic="incompatible" addition="yes"/>
<description>
<p>
API for Call EJB action.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="EjbResourceConfiguration"/>
<issue number="89439"/>
</change>
<change id="ResourceApiRedesign">
<api name="j2eeserver"/>
<summary>
Adding an API for working with data sources, message-driven beans and JMS messages
</summary>
<version major="1" minor="25"/>
<date day="5" month="4" year="2007"/>
<author login="lkotouc"/>
<compatibility binary="incompatible" source="incompatible" semantic="incompatible" addition="yes"/>
<description>
<p>
API for working with data sources, message-driven beans and JMS messages.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.common.api" name="MessageDestination"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="MessageDestinationDeployment"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="OptionalDeploymentManagerFactory"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="DatasourceConfiguration"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="MessageDestinationConfiguration"/>
<issue number="89439"/>
</change>
<change id="jdbcDriverDeployment">
<api name="j2eeserver"/>
<summary>
Adding an API for JDBC driver deployment.
</summary>
<version major="1" minor="24"/>
<date day="28" month="3" year="2007"/>
<author login="sherold"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
API for JDBC driver deployment.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="JDBCDriverDeployer"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="OptionalDeploymentManagerFactory"/>
<issue number="89439"/>
</change>
<change id="ddbeanRemoval">
<api name="j2eeserver"/>
<summary>
Removing dependency of configuration releated part of the J2EE Server API on JSR-88.
Splitting up the plugin API to API and SPI.
</summary>
<version major="1" minor="23"/>
<date day="11" month="3" year="2007"/>
<author login="sherold"/>
<compatibility binary="incompatible" source="incompatible" semantic="incompatible" addition="yes"/>
<description>
<p>
The initial motivation for the J2EE Server API changes is migration to Retouche, a new
NetBeans Java infrastructure. The new Java infrastructure does not supply the old deployment
descriptor model with fine-grained change notification events anymore and thus a new Merged
deployment descriptor model infrastructure was created instead.
</p>
<p>
Since the architecture of the new Merged deployment descriptor model is essentially different
from the old deployment descriptor model infrastructure, the model can no longer be wrapped in
the JSR-88 DDBean wrapper, which was a basis of all the server specific deployment configuration
APIs, the deployment configuration related part of the J2EE Server API had to be redesigned.
</p>
<p>
Because the redesign already introduced big incompatible changes, we took advantage of it to
fix couple of API issues, which required incompatible changes. First, the server plug-in part
of the API was split into API and SPI. So far, there was no clear distinction between API and
SPI and it was not obvious what a server plug-in writer is required to implement. Second,
throws ConfigurationException clause was added to all the server-specific configuration
related methods to inform the client about a problem which might have occurred when reading or
writing to server-specific configuration files.
</p>
<p>
For further description refer to the issue.
</p>
</description>
<class package="org.netbeans.modules.j2ee.deployment.common.api" name="ConfigurationException"/>
<class package="org.netbeans.modules.j2ee.deployment.common.api" name="SourceFileMap"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="J2eeApplication"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="J2eeModule"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.api" name="J2eeModuleContainer" link="no"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeApplicationImplementation"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeApplicationProvider"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeAppProvider" link="no"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleFactory"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleImplementation"/>
<class package="org.netbeans.modules.j2ee.deployment.devmodules.spi" name="J2eeModuleProvider"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="ConfigurationSupport" link="no"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.api" name="FileJ2eeModuleQuery"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="DatasourceManager" link="no"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi" name="IncrementalDeployment"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="ContextRootConfiguration"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="DatasourceConfiguration"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="DeploymentPlanConfiguration"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="EjbResourceConfiguration"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="MappingConfiguration"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="ModuleConfigurationFactory"/>
<class package="org.netbeans.modules.j2ee.deployment.plugins.spi.config" name="ModuleConfiguration"/>
<issue number="99217"/>
</change>
<change id="settableTimeouts">
<api name="plugins"/>
<summary>
New static fields on InstanceProperties
</summary>
<version major="1" minor="22"/>
<date day="22" month="3" year="2007"/>
<author login="vkraemer"/>
<compatibility binary="compatible" source="compatible" semantic="compatible" addition="yes"/>
<description>
<p>
Eliminate completely hard-code timeout for startup, shutdown
and deployment operations. Current hard-coded timeouts
remain the default for plugins that do not provide
per-instance settings.
</p>