<
From version < 28.6 >
edited by Vincent Massol
on 2010/10/25
To version < 30.1 >
edited by Sergiu Dumitriu
on 2010/10/25
>
Change comment: Updated API breakages

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.VincentMassol
1 +XWiki.Sergiu
Content
... ... @@ -156,9 +156,9 @@
156 156  
157 157  == Experimental xwiki/2.1 wiki syntax ==
158 158  
159 -The xwiki wiki syntax sees further improvements as xwiki/2.1 is still in an experimental stage. A new feature is an enhanced syntax for links, which is more generic and allows easier extensions with new link types, demonstrated in this release with support for path and [[interwiki links>>http://en.wikipedia.org/wiki/Interwiki_links]].
159 +The xwiki wiki syntax sees further improvements as xwiki/2.1 is still in an experimental stage. A new feature is an enhanced syntax for links and images, which is more generic and allows easier extensions with new link types, demonstrated in this release with support for path and [[interwiki links>>http://en.wikipedia.org/wiki/Interwiki_links]].
160 160  
161 -Basic syntax:
161 +Basic syntax for links:
162 162  
163 163  {{code language="none"}}
164 164  [[label>>referenceType:referenceData]]
... ... @@ -178,13 +178,29 @@
178 178  {{velocity}}[[reset the history>>path:$doc.getURL('reset')||queryString="confirm=1"]]{{/velocity}}
179 179  {{/code}}
180 180  
181 -{{info}}This syntax is not enabled by default, you must edit ##xwiki.cfg## and add it to the ##xwiki.rendering.syntaxes## setting to try it out.{{/info}}
181 +Basic syntax for images:
182 182  
183 +{{code language="none"}}
184 +image:referenceType:referenceData
185 +[[image:referenceType:referenceData||paramN=valueN]]
186 +{{/code}}
187 +
188 +{{info}}
189 +This syntax is not enabled by default, you must edit ##xwiki.cfg## and add it to the ##xwiki.rendering.syntaxes## setting to try it out.
190 +{{/info}}
191 +
183 183  === [[Interwiki links>>http://en.wikipedia.org/wiki/Interwiki_links]] ===
184 184  
185 -Basic syntax:
194 +Basic syntax for XWiki Syntax 2.0:
186 186  
187 187  {{code language="none"}}
197 +[[label>>path@interwikiAlias]]
198 +[[Interwiki links>>Interwiki_links@wikipedia]]
199 +{{/code}}
200 +
201 +Basic syntax for XWiki Syntax 2.1:
202 +
203 +{{code language="none"}}
188 188  [[label>>interwiki:wikiAlias:path/data]]
189 189  [[Interwiki links>>interwiki:wikipedia:Interwiki_links]]
190 190  {{/code}}
... ... @@ -249,14 +249,28 @@
249 249  
250 250  == General Notes ==
251 251  
252 -{{warning}}If you're running in a multiwiki setup you'll also need to define the property //xwiki.store.migration.databases=all// to your //xwiki.cfg// file or explicitly name all databases to be migrated as in //xwiki.store.migration.databases=db1,db2,...//.{{/warning}}
268 +{{warning}}
269 +If you're running in a multiwiki setup you'll also need to define the property //xwiki.store.migration.databases=all// to your //xwiki.cfg// file or explicitly name all databases to be migrated as in //xwiki.store.migration.databases=db1,db2,...//.
270 +{{/warning}}
253 253  
254 254  You may also want to [[import the default wiki XAR>>Main.Download]] in order to benefit from the improvements listed above.
255 255  
256 -{{warning}}Always make sure you compare your //xwiki.cfg// file with the newest version since some configuration parameters were added. Note 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.{{/warning}}
274 +{{warning}}
275 +Always make sure you compare your //xwiki.cfg// file with the newest version since some configuration parameters were added. Note 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.
276 +{{/warning}}
257 257  
258 -{{warning}}Experimental support for CSRF protection is included in this release, although not enabled by default. This mechanism changes the way data is supposed to be saved, a change which will not completely break custom applications in most cases, but which might insert an extra validation step needed for actually saving the data.{{/warning}}
278 +== Migration Notes ==
259 259  
280 +The main entry point for the search UI is now the Main.Search page that will use the configured search engine (Lucene by default). If you want to refer to Lucene or Database search explicitly you can use the ##Main.LuceneSearch## and ##Main.DatabaseSearch## pages. Note that nothing is broken here (##Main.WebSearch## page is still there and internally it includes the ##Main.DatabaseSearch## page), it's just the new clean way of targeting the search page.
281 +
282 +=== Testing CSRF protection ===
283 +
284 +An experimental support for CSRF protection is included in this release, although not enabled by default.
285 +
286 +{{warning}}
287 +This mechanism changes the way data is supposed to be saved, a change which will not completely break custom applications in most cases, but which might insert an extra validation step needed for actually saving the data.
288 +{{/warning}}
289 +
260 260  It is **strongly recommended** to set up a testing/development environment, enable this feature and fully test all the code. In most cases things should work with no additional changes. If the default edit mode is not used, or if the default velocity templates are not used, it should be enough to add the following line:
261 261  
262 262  {{code language="html"}}
... ... @@ -263,10 +263,6 @@
263 263  <input type="hidden" name="form_token" value="$!{services.csrf.getToken()}" />
264 264  {{/code}}
265 265  
266 -== Migration Notes ==
267 -
268 -The main entry point for the search UI is now the Main.Search page that will use the configured search engine (Lucene by default). If you want to refer to Lucene or Database search explicitly you can use the ##Main.LuceneSearch## and ##Main.DatabaseSearch## pages. Note that nothing is broken here (##Main.WebSearch## page is still there and internally it includes the ##Main.DatabaseSearch## page), it's just the new clean way of targeting the search page.
269 -
270 270  === Removed deprecated flickr plugin ===
271 271  
272 272  The old flickr plugin was outdated and the API was broken, so, as a consequence, it has been removed. A new plugin will be available in the future. Meanwhile you can still find it in the contrib-retired at this [[link>>http://svn.xwiki.org/svnroot/xwiki/contrib/retired/plugin-flickr/]].
... ... @@ -280,8 +280,81 @@
280 280  The following APIs were modified since XWiki Enterprise 2.4.4:
281 281  
282 282  {{code language="none"}}
283 -[ERROR] org.xwiki.rendering.transformation.MacroTransformationContext: Method 'public org.xwiki.rendering.internal.transformation.MacroTransformation getMacroTransformation()' has been removed
284 -[ERROR] org.xwiki.rendering.transformation.MacroTransformationContext: Method 'public void setMacroTransformation(org.xwiki.rendering.internal.transformation.MacroTransformation)' has been removed
285 -[ERROR] org.xwiki.rendering.transformation.Transformation: Method 'public void transform(org.xwiki.rendering.block.Block, org.xwiki.rendering.transformation.TransformationContext)' has been added to an interface
286 -[ERROR] org.xwiki.rendering.transformation.TransformationManager: Method 'public void performTransformations(org.xwiki.rendering.block.Block, org.xwiki.rendering.transformation.TransformationContext)' has been added to an interface
309 +[ERROR] org.xwiki.rendering.scaffolding.MockWikiModel: In method 'public java.lang.String getAttachmentURL(java.lang.String, java.lang.String)' the number of arguments has changed
310 +[ERROR] org.xwiki.rendering.scaffolding.MockWikiModel: In method 'public java.lang.String getDocumentEditURL(java.lang.String, java.lang.String, java.lang.String)' the number of arguments has changed
311 +[ERROR] org.xwiki.rendering.scaffolding.MockWikiModel: In method 'public java.lang.String getDocumentViewURL(java.lang.String, java.lang.String, java.lang.String)' the number of arguments has changed
312 +[ERROR] org.xwiki.rendering.scaffolding.MockWikiModel: Parameter 1 of 'public boolean isDocumentAvailable(java.lang.String)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
313 +[ERROR] org.xwiki.rendering.scaffolding.RenderingTestSuite: In method 'public void addTestsFromResource(java.lang.String, boolean)' the number of arguments has changed
314 +[ERROR] org.xwiki.rendering.scaffolding.RenderingTestSuite: Method 'public void addTestsFromResource(java.lang.String, boolean, java.util.Map)' has been removed
315 +[ERROR] org.xwiki.rendering.macro.script.AbstractJSR223ScriptMacro: Method 'protected boolean canExecuteScript()' has been removed
316 +[ERROR] org.xwiki.rendering.macro.script.AbstractJSR223ScriptMacro: Method 'public java.util.List execute(org.xwiki.rendering.macro.script.JSR223ScriptMacroParameters, java.lang.String, org.xwiki.rendering.transformation.MacroTransformationContext)' has been removed
317 +[ERROR] org.xwiki.rendering.macro.script.AbstractScriptMacro: Method 'protected boolean canHaveJarsParameters()' has been removed
318 +[ERROR] org.xwiki.rendering.macro.script.AbstractScriptMacro: Method 'protected java.lang.ClassLoader getClassLoader(java.lang.String, java.lang.ClassLoader)' has been removed
319 +[ERROR] org.xwiki.rendering.block.ImageBlock: Parameter 1 of 'public ImageBlock(org.xwiki.rendering.listener.Image, boolean)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
320 +[ERROR] org.xwiki.rendering.block.ImageBlock: Parameter 1 of 'public ImageBlock(org.xwiki.rendering.listener.Image, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
321 +[ERROR] org.xwiki.rendering.block.ImageBlock: Method 'public org.xwiki.rendering.listener.Image getImage()' has been removed
322 +[ERROR] org.xwiki.rendering.block.LinkBlock: Parameter 2 of 'public LinkBlock(java.util.List, org.xwiki.rendering.listener.Link, boolean)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
323 +[ERROR] org.xwiki.rendering.block.LinkBlock: Parameter 2 of 'public LinkBlock(java.util.List, org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
324 +[ERROR] org.xwiki.rendering.block.LinkBlock: Method 'public org.xwiki.rendering.listener.Link getLink()' has been removed
325 +[ERROR] org.xwiki.rendering.block.PlainTextBlockFilter: Parameter 2 of 'public PlainTextBlockFilter(org.xwiki.rendering.parser.Parser, org.xwiki.rendering.renderer.LinkLabelGenerator)' has changed its type to org.xwiki.rendering.renderer.reference.link.LinkLabelGenerator
326 +[ERROR] org.xwiki.rendering.configuration.RenderingConfiguration: Method 'public java.util.Properties getInterWikiDefinitions()' has been added to an interface
327 +[ERROR] org.xwiki.rendering.listener.AbstractImage: Class org.xwiki.rendering.listener.AbstractImage removed
328 +[ERROR] org.xwiki.rendering.listener.Attachment: Class org.xwiki.rendering.listener.Attachment removed
329 +[ERROR] org.xwiki.rendering.listener.CompositeListener: Parameter 1 of 'public void beginLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
330 +[ERROR] org.xwiki.rendering.listener.CompositeListener: Parameter 1 of 'public void endLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
331 +[ERROR] org.xwiki.rendering.listener.CompositeListener: Parameter 1 of 'public void onImage(org.xwiki.rendering.listener.Image, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
332 +[ERROR] org.xwiki.rendering.listener.DefaultAttachment: Class org.xwiki.rendering.listener.DefaultAttachment removed
333 +[ERROR] org.xwiki.rendering.listener.DocumentImage: Class org.xwiki.rendering.listener.DocumentImage removed
334 +[ERROR] org.xwiki.rendering.listener.Image: Class org.xwiki.rendering.listener.Image removed
335 +[ERROR] org.xwiki.rendering.listener.ImageListener: Parameter 1 of 'public void onImage(org.xwiki.rendering.listener.Image, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
336 +[ERROR] org.xwiki.rendering.listener.ImageType: Class org.xwiki.rendering.listener.ImageType removed
337 +[ERROR] org.xwiki.rendering.listener.Link: Class org.xwiki.rendering.listener.Link removed
338 +[ERROR] org.xwiki.rendering.listener.LinkListener: Parameter 1 of 'public void beginLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
339 +[ERROR] org.xwiki.rendering.listener.LinkListener: Parameter 1 of 'public void endLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
340 +[ERROR] org.xwiki.rendering.listener.LinkType: Class org.xwiki.rendering.listener.LinkType removed
341 +[ERROR] org.xwiki.rendering.listener.QueueListener: Parameter 1 of 'public void beginLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
342 +[ERROR] org.xwiki.rendering.listener.QueueListener: Parameter 1 of 'public void endLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
343 +[ERROR] org.xwiki.rendering.listener.QueueListener: Parameter 1 of 'public void onImage(org.xwiki.rendering.listener.Image, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
344 +[ERROR] org.xwiki.rendering.listener.URLImage: Class org.xwiki.rendering.listener.URLImage removed
345 +[ERROR] org.xwiki.rendering.listener.WrappingListener: Parameter 1 of 'public void beginLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
346 +[ERROR] org.xwiki.rendering.listener.WrappingListener: Parameter 1 of 'public void endLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
347 +[ERROR] org.xwiki.rendering.listener.WrappingListener: Parameter 1 of 'public void onImage(org.xwiki.rendering.listener.Image, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
348 +[ERROR] org.xwiki.rendering.listener.chaining.AbstractChainingListener: Parameter 1 of 'public void beginLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
349 +[ERROR] org.xwiki.rendering.listener.chaining.AbstractChainingListener: Parameter 1 of 'public void endLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
350 +[ERROR] org.xwiki.rendering.listener.chaining.AbstractChainingListener: Parameter 1 of 'public void onImage(org.xwiki.rendering.listener.Image, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
351 +[ERROR] org.xwiki.rendering.listener.chaining.BlockStateChainingListener: Parameter 1 of 'public void beginLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
352 +[ERROR] org.xwiki.rendering.listener.chaining.BlockStateChainingListener: Parameter 1 of 'public void endLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
353 +[ERROR] org.xwiki.rendering.listener.chaining.BlockStateChainingListener: Parameter 1 of 'public void onImage(org.xwiki.rendering.listener.Image, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
354 +[ERROR] org.xwiki.rendering.listener.chaining.ConsecutiveNewLineStateChainingListener: Parameter 1 of 'public void endLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
355 +[ERROR] org.xwiki.rendering.listener.chaining.ConsecutiveNewLineStateChainingListener: Parameter 1 of 'public void onImage(org.xwiki.rendering.listener.Image, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
356 +[ERROR] org.xwiki.rendering.listener.chaining.EmptyBlockChainingListener: Parameter 1 of 'public void beginLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
357 +[ERROR] org.xwiki.rendering.listener.chaining.EmptyBlockChainingListener: Parameter 1 of 'public void endLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
358 +[ERROR] org.xwiki.rendering.listener.chaining.EmptyBlockChainingListener: Parameter 1 of 'public void onImage(org.xwiki.rendering.listener.Image, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
359 +[ERROR] org.xwiki.rendering.listener.chaining.LookaheadChainingListener: Parameter 1 of 'public void beginLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
360 +[ERROR] org.xwiki.rendering.listener.chaining.LookaheadChainingListener: Parameter 1 of 'public void endLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
361 +[ERROR] org.xwiki.rendering.listener.chaining.LookaheadChainingListener: Parameter 1 of 'public void onImage(org.xwiki.rendering.listener.Image, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
362 +[ERROR] org.xwiki.rendering.listener.chaining.TextOnNewLineStateChainingListener: Parameter 1 of 'public void beginLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
363 +[ERROR] org.xwiki.rendering.listener.chaining.TextOnNewLineStateChainingListener: Parameter 1 of 'public void endLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
364 +[ERROR] org.xwiki.rendering.listener.chaining.TextOnNewLineStateChainingListener: Parameter 1 of 'public void onImage(org.xwiki.rendering.listener.Image, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
365 +[ERROR] org.xwiki.rendering.parser.AttachmentParser: Class org.xwiki.rendering.parser.AttachmentParser removed
366 +[ERROR] org.xwiki.rendering.parser.ImageParser: Class org.xwiki.rendering.parser.ImageParser removed
367 +[ERROR] org.xwiki.rendering.parser.LinkParser: Class org.xwiki.rendering.parser.LinkParser removed
368 +[ERROR] org.xwiki.rendering.renderer.LinkLabelGenerator: Class org.xwiki.rendering.renderer.LinkLabelGenerator removed
369 +[ERROR] org.xwiki.rendering.renderer.LinkReferenceSerializer: Class org.xwiki.rendering.renderer.LinkReferenceSerializer removed
370 +[ERROR] org.xwiki.rendering.renderer.URILabelGenerator: Class org.xwiki.rendering.renderer.URILabelGenerator removed
371 +[ERROR] org.xwiki.rendering.renderer.XWikiSyntaxListenerChain: Class org.xwiki.rendering.renderer.XWikiSyntaxListenerChain removed
372 +[ERROR] org.xwiki.rendering.renderer.xhtml.XHTMLImageRenderer: Class org.xwiki.rendering.renderer.xhtml.XHTMLImageRenderer removed
373 +[ERROR] org.xwiki.rendering.renderer.xhtml.XHTMLLinkRenderer: Class org.xwiki.rendering.renderer.xhtml.XHTMLLinkRenderer removed
374 +[ERROR] org.xwiki.rendering.wiki.WikiModel: In method 'public java.lang.String getAttachmentURL(java.lang.String, java.lang.String)' the number of arguments has changed
375 +[ERROR] org.xwiki.rendering.wiki.WikiModel: In method 'public java.lang.String getDocumentEditURL(java.lang.String, java.lang.String, java.lang.String)' the number of arguments has changed
376 +[ERROR] org.xwiki.rendering.wiki.WikiModel: In method 'public java.lang.String getDocumentViewURL(java.lang.String, java.lang.String, java.lang.String)' the number of arguments has changed
377 +[ERROR] org.xwiki.rendering.wiki.WikiModel: Method 'public java.lang.String getImageURL(org.xwiki.rendering.listener.reference.ResourceReference, java.util.Map)' has been added to an interface
378 +[ERROR] org.xwiki.rendering.wiki.WikiModel: Parameter 1 of 'public boolean isDocumentAvailable(java.lang.String)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
379 +[ERROR] org.xwiki.bridge.DocumentAccessBridge: Method 'public java.lang.String getAttachmentURL(org.xwiki.model.reference.AttachmentReference, java.lang.String, boolean)' has been added to an interface
380 +[ERROR] org.xwiki.bridge.DocumentAccessBridge: Method 'public java.lang.String getAttachmentVersion(org.xwiki.model.reference.AttachmentReference)' has been added to an interface
381 +[ERROR] org.xwiki.bridge.DocumentAccessBridge: Method 'public java.lang.String getDocumentURL(org.xwiki.model.reference.DocumentReference, java.lang.String, java.lang.String, java.lang.String, boolean)' has been added to an interface
382 +[ERROR] org.xwiki.annotation.renderer.AbstractAnnotationRenderer: Return type of method 'public org.xwiki.rendering.renderer.LinkLabelGenerator getLinkLabelGenerator()' has been changed to org.xwiki.rendering.renderer.reference.link.LinkLabelGenerator
383 +[ERROR] org.xwiki.annotation.renderer.LinkLabelGeneratorChainingListener: Changed type of field linkLabelGenerator from org.xwiki.rendering.renderer.LinkLabelGenerator to org.xwiki.rendering.renderer.reference.link.LinkLabelGenerator
384 +[ERROR] org.xwiki.annotation.renderer.LinkLabelGeneratorChainingListener: Parameter 1 of 'public LinkLabelGeneratorChainingListener(org.xwiki.rendering.renderer.LinkLabelGenerator, org.xwiki.rendering.parser.StreamParser, org.xwiki.rendering.listener.chaining.ListenerChain)' has changed its type to org.xwiki.rendering.renderer.reference.link.LinkLabelGenerator
385 +[ERROR] org.xwiki.annotation.renderer.LinkLabelGeneratorChainingListener: Parameter 1 of 'public void endLink(org.xwiki.rendering.listener.Link, boolean, java.util.Map)' has changed its type to org.xwiki.rendering.listener.reference.ResourceReference
287 287  {{/code}}

Get Connected