Skip to Content

Version 9.2 by Thomas Mortagne on 2012/03/14
Show last authors
1 (% style="font-size:x-large;" %)
2 {{warning}}Before upgrading to this version, be sure to have a working backup of your database(s).{{/warning}}
3
4 {{box cssClass="floatinginfobox" title="**Contents**"}}
5 {{toc/}}
6 {{/box}}
7
8 This is the first milestone of the XWiki Enterprise 4.0 version ([[Roadmap>>Main.Roadmap]]). This release brings reduced document database id collision and quite a few improvements and bug fixes.
9
10 = New and Noteworthy (since XWiki Enterprise 3.5 version) =
11
12 == Extension Manager improvements ==
13
14 === Extension Manager ===
15
16 * Added possibility to choose on which wiki to install an extension
17 * When installing/uninstalling extension or any other background job, the result of the job executing is stored on the filesystem so that it can be reviewed later. There is no UI to access it yet but it's always possible to access the saved file on filesystem directly.
18
19 === XWiki Repository ===
20
21 * Added a button to update an imported extension
22 * It's now possible to extend an Extension sheet with custom informations. For example http://extensions.xwiki.org adds "Bundled with" and "Compatibility" fields.
23
24 = For developers =
25
26 == Extension Manager moved to commons ==
27
28 Everything not not specifically related to wiki is now part of xwiki-commons. That means that anyone can get all Extension Manager features (easy live JAR installation/uninstallation from remote repositories, dependency management, etc.) in any Java application.
29
30 == Classloader module moved to commons ==
31
32 Mostly been moved as Extension Manager dependency but also useful on it own as a tool to dynamically add new URLs in a classloader at runtime.
33
34 == New Job module ==
35
36 The code to execute a task in backgroup and provide related progress and isolated log has been extracted from Extension Manager and is now in its own module.
37
38 == Component related improvements ==
39
40 === Role moved from Class to Type ===
41
42 In order to support parameterized role like DocumentReferenceResolver<String>, all the APIs of ComponentManager and Component descriptors has been changed to take Type instead of Class. All the old API are still here and working but deprecated.
43
44 === ComponentRole is deprecated ===
45
46 You should now use @Role instead of @ComponentRole. The difference is that when using @Role the generic parameters will be taken into account as part of the role while with @ComponentRole the role stay the Class of the component role so be careful when you do this change, it might break everything if you don't want to take into account parameters (that's why a new annotation has been introduced instead of changing the behavior of ComponentRole).
47
48 === References resolver/serializer and Provider now support parameter type as part of the role ===
49
50 This mean that declaring or injecting a such component no longer require any hint unless you want to provide/inject a variant for the same type.
51
52 Here are some example. Instead of:
53
54 {{code language="java"}}
55 @Inject
56 @Named("reference/default")
57 private DocumentReferenceResolver<EntityReference> resolver
58
59 @Inject
60 @Named("reference/current")
61 private DocumentReferenceResolver<EntityReference> resolver
62
63 @Inject
64 @Named("sometypeprovider")
65 private Provider<SomeType> resolver
66 {{/code}}
67
68 you will write
69
70 {{code language="java"}}
71 @Inject
72 private DocumentReferenceResolver<EntityReference> resolver
73
74 @Inject
75 @Named("current")
76 private DocumentReferenceResolver<EntityReference> resolver
77
78 @Inject
79 private Provider<SomeType> resolver
80 {{/code}}
81
82 All reference resolver and serializer provide static variables with the Type for both String and EntityReference. For example you can write:
83
84 {{code language="java"}}
85 DocumentReferenceResolver<EntityReference> resolver = componentManager.lookupComponent(DocumentReferenceResolver.TYPE_REFERENCE, "current")
86 {{/code}}
87
88 = Bug fixes and improvements =
89
90 * [[XE-1096>>http://jira.xwiki.org/browse/XE-1096]] The attachment selector should also work with the ##/edit/## action in 'Inline form' edit mode
91 * [[XE-1105>>http://jira.xwiki.org/browse/XE-1105]] Default class sheet doesn't display correctly the class title
92 * [[XWIKI-7411>>http://jira.xwiki.org/browse/XWIKI-7411]] Cannot import a XAR containing ##%3A## in its file name
93 * [[XWIKI-6305>>http://jira.xwiki.org/browse/XWIKI-6305]] Keep the current user in the administration application when editing user details
94 * [[XWIKI-7462>>http://jira.xwiki.org/browse/XWIKI-7462]] Improve the Profile breadcrumb to be more user friendly
95 * [[XWIKI-7484>>http://jira.xwiki.org/browse/XWIKI-7484]] Write a log line in the console instructing the user to open XWiki in a browser
96
97 See the full list of [[JIRA issues>>http://jira.xwiki.org/sr/jira.issueviews:searchrequest-printable/temp/SearchRequest.html?jqlQuery=project+in+%28XCOMMONS%2C+XRENDERING%2C+XWIKI%2C+XE%2C+XEM%29+and+status+%3D+Closed+and+resolution+%3D+Fixed+and+fixVersion+%3D+%223.5-milestone-1%22&tempMax=1000]] fixed in this release.
98
99 = For Developers =
100
101 * [[XCOMMONS-94>>http://jira.xwiki.org/browse/XCOMMONS-94]] Set the minimum required Maven version (3.0) to build XWiki in the POM
102 * [[XWIKI-7502>>http://jira.xwiki.org/browse/XWIKI-7502]] Replace notion of Container's ApplicationContext with the notion of Environment
103 * [[XWIKI-7476>>http://jira.xwiki.org/browse/XWIKI-7476]] Sheets need to be able to display the title of the document they are applied to
104 * [[XWIKI-7526>>http://jira.xwiki.org/browse/XWIKI-7526]] Enable Infinispan JMX mbeans by default for runtime monitoring of XWiki caches
105 * [[XWIKI-7504>>http://jira.xwiki.org/browse/XWIKI-7504]] Files within WEB-INF directory readable by using Velocity
106 * [[XE-1108>>http://jira.xwiki.org/browse/XE-1108]] Provide tomcat5 and tomcat7 based Debian packages
107
108 == Upgrades ==
109
110 The following dependencies have been upgraded:
111
112 * commons-codec 1.6
113 * commons-configuration 1.8
114 * commons-io 2.1
115 * commons-net 3.1
116 * HyperSQL 2.2.8
117 * Infinispan 5.1.1
118 * Junit 4.10
119 * Maven Clover plugin 3.1.4
120 * Selenium 2.20
121
122 = Tested Browsers =
123
124 Here's the list of browsers tested with this version (i.e. browsers that we've tested as working - Check the list of [[supported browsers>>dev:Community.BrowserSupportStrategy]]):
125
126 {{todo/}}
127
128 = Known issues =
129
130 * [[Bugs we know about>>http://jira.xwiki.org/secure/IssueNavigator.jspa?reset=true&jqlQuery=category+%3D+%22Top+Level+Projects%22+AND+issuetype+%3D+Bug+AND+resolution+%3D+Unresolved+ORDER+BY+updated+DESC]]
131
132 = Test Report =
133
134 You can check the [[manual test report>>TestReports.ManualTestReportXE40M1]] to learn about what was tested and the results on various browsers.
135
136 = Backward Compatibility and Migration Notes =
137
138 == Migration of database IDs ==
139
140 You need to enable database migration (//xwiki.store.migration=1//) to upgrade existing databases to the new identifier format.
141
142 {{info}}
143 This is a major migration affecting almost all rows and relations in the database. I may takes a while before the wiki respond to your initial request when you are migrating a large database. The initial request may even timeout but the database migration continue in the background.
144 {{/info}}
145
146 {{warning}}
147 Avoid to interrupt the database migration process and check the current progress of the database migration in the console output or the log file. The progress may be slow, so be patient during document id and object id conversion.
148 {{/warning}}
149
150 In case of interruption, the migration procedure could be restarted by restarting XWiki, and it will start over where it have been interrupted.
151
152 {{warning}}
153 We have taken many precaution to provide a reliable migration procedure, but due to the large changes it made, and this release being an unstable one, you should be really careful and ensure that you keep an appropriate backup until you are sure that your data has been properly migrated.
154 {{/warning}}
155
156 If you have custom mapped classes used externally, be aware that all internal identifier are now full 64bits longs.
157
158 == General Notes ==
159
160 {{info}}
161 If you're running in a multiwiki setup you'll also need to define the property //xwiki.store.migration.databases// in your //xwiki.cfg// file if you want to explicitly name some databases to be migrated as the default is now to migrate all databases. Database that are not migrated could not be accessed.
162 {{/info}}
163
164 You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from all the improvements listed above.
165
166 {{warning}}
167 Always make sure you compare your ##xwiki.cfg## and ##xwiki.properties## files with the newest version since some configuration parameters were added. Note that you should add ##xwiki.store.migration=1## so that XWiki will attempt to automatically migrate your current database to the new schema. Make sure you backup your Database before doing anything.
168 {{/warning}}
169
170 == API Breakages ==
171
172 The following APIs were modified since version 3.5:
173
174 {{code language="none"}}
175 org.xwiki.component.descriptor.ComponentRole: Method 'public java.lang.reflect.Type getRoleType()' has been added to an interface
176 org.xwiki.component.manager.ComponentManager: Method 'public org.xwiki.component.descriptor.ComponentDescriptor getComponentDescriptor(java.lang.reflect.Type, java.lang.String)' has been added to an interface
177 org.xwiki.component.manager.ComponentManager: Method 'public java.util.List getComponentDescriptorList(java.lang.reflect.Type)' has been added to an interface
178 org.xwiki.component.manager.ComponentManager: Method 'public boolean hasComponent(java.lang.reflect.Type)' has been added to an interface
179 org.xwiki.component.manager.ComponentManager: Method 'public boolean hasComponent(java.lang.reflect.Type, java.lang.String)' has been added to an interface
180 org.xwiki.component.manager.ComponentManager: Method 'public java.lang.Object lookupComponent(java.lang.reflect.Type)' has been added to an interface
181 org.xwiki.component.manager.ComponentManager: Method 'public java.lang.Object lookupComponent(java.lang.reflect.Type, java.lang.String)' has been added to an interface
182 org.xwiki.component.manager.ComponentManager: Method 'public java.util.List lookupList(java.lang.reflect.Type)' has been added to an interface
183 org.xwiki.component.manager.ComponentManager: Method 'public java.util.Map lookupMap(java.lang.reflect.Type)' has been added to an interface
184 org.xwiki.component.manager.ComponentManager: Method 'public void unregisterComponent(java.lang.reflect.Type, java.lang.String)' has been added to an interface
185 org.xwiki.component.manager.ComponentManager: Method 'public void unregisterComponent(org.xwiki.component.descriptor.ComponentDescriptor)' has been added to an interface
186 org.xwiki.component.annotation.DefaultComponentDependencyFactory: Method 'protected java.lang.Class getFieldRole(java.lang.reflect.Field)' has been removed
187 {{/code}}

About

About

Support

Platform

User Guide

Admin Guide

Developer Guide

Projects

XWiki

Extensions

Other

Contribute

Status

Practices

Under the Hood

Get Involved

Get Connected