Wiki source code of Release Notes XWiki 7.4 Milestone 2
Version 17.1 by Vincent Massol on 2015/12/15
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{box cssClass="floatinginfobox" title="**Contents**"}} | ||
| 2 | {{toc/}} | ||
| 3 | {{/box}} | ||
| 4 | |||
| 5 | This is the release notes for [[XWiki Commons>>http://commons.xwiki.org]], [[XWiki Rendering>>http://rendering.xwiki.org]], [[XWiki Platform>>http://platform.xwiki.org]] and [[XWiki Enterprise>>http://enterprise.xwiki.org]]. They share the same release notes as they are released together and have the same version. | ||
| 6 | |||
| 7 | This is our last stabilization branch for the XWiki 7.x Cycle. It brings polishing and stabilization for the Nested Pages feature and the changes in UI that resulted from it. It also introduce a new API to indicate how long a cache entry to stay in the cache (since it was inserted in the cache). | ||
| 8 | |||
| 9 | = New and Noteworthy (since XWiki 7.4 Milestone 1) = | ||
| 10 | |||
| 11 | [[Full list of issues fixed and Dashboard for 7.4>>http://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=13590]]. | ||
| 12 | |||
| 13 | == Miscellaneous == | ||
| 14 | |||
| 15 | * The "annotations" button in the "More Actions" menu has been moved in the same menu but with other actions and renamed "Annotate".((( | ||
| 16 | {{image reference="Annotate.png"/}} | ||
| 17 | ))) | ||
| 18 | |||
| 19 | 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%29+and+status+%3D+Closed+and+resolution+%3D+Fixed+and+fixVersion+%3D+%227.4-milestone-2%22&tempMax=1000]] fixed in this release. | ||
| 20 | |||
| 21 | = For Developers = | ||
| 22 | |||
| 23 | == New lifespan LRU Cache setup == | ||
| 24 | |||
| 25 | It's now possible to define the maximum time to live since the entry is put in the cache. It used to be possible to set it only since the last time the value was used. | ||
| 26 | |||
| 27 | {{code language="java"}} | ||
| 28 | // Configure cache eviction policy | ||
| 29 | LRUEvictionConfiguration lru = new LRUEvictionConfiguration(); | ||
| 30 | // Set maximum size of the cache as 1000 entries | ||
| 31 | lru.setMaxEntries(1000); | ||
| 32 | // Set the maximum time to live since when the entry is used to 1 hour | ||
| 33 | lru.setMaxIdle(3600) | ||
| 34 | // Set the maximum time to live since when the entry is put in the cache to 1 hour | ||
| 35 | lru.setLifespan(3600) | ||
| 36 | {{/code}} | ||
| 37 | |||
| 38 | [[Cache Macro>>extensions:Extension.Cache Macro]] and [[Rendering Cache>>platform:AdminGuide.Performances||anchor="HRenderingcache"]] are now based on this behavior. | ||
| 39 | |||
| 40 | == Deprecated and Retired projects == | ||
| 41 | |||
| 42 | * XML-RPC module have been moved to https://github.com/xwiki-contrib/xwiki-platform-xmlrpc | ||
| 43 | |||
| 44 | == Upgrades == | ||
| 45 | |||
| 46 | The following dependencies have been upgraded: | ||
| 47 | |||
| 48 | * [[Batik 1.8>>http://jira.xwiki.org/browse/XWIKI-12904]] | ||
| 49 | * [[FOP 2.0>>http://jira.xwiki.org/browse/XWIKI-12871]] | ||
| 50 | * [[Jackson 2.6.4>>http://jira.xwiki.org/browse/XCOMMONS-893]] | ||
| 51 | * [[guava 19>>http://jira.xwiki.org/browse/XCOMMONS-894]] | ||
| 52 | * [[Less4j 1.15.4>>http://jira.xwiki.org/browse/XWIKI-12905]] | ||
| 53 | |||
| 54 | == VFS API == | ||
| 55 | |||
| 56 | Replacement of the [[Zip Explorer Plugin>>extensions:Extension.ZIP Explorer Plugin]]. API to access the content of archives files (zip, jar, gzip, tar, etc) located as attachments in wiki pages or elsewhere (external URLs, file system, et). | ||
| 57 | |||
| 58 | In addition a new [[Velocity Tool>>extensions:Extension.Velocity Module||anchor="HVelocityTools"]] was added in order to be able to use a portion of the NIO2 API from Velocity: ##niotool##. | ||
| 59 | |||
| 60 | See [[VFS API>>extensions:Extension.VFS API]] and [[VFS Tree Macro>>extensions:Extension.VFS Tree Macro]] for more details. Some examples: | ||
| 61 | |||
| 62 | {{code language="velocity"}} | ||
| 63 | {{velocity}} | ||
| 64 | ## Get the URL to access the content of a file inside a zip: | ||
| 65 | [[link to file in zip>>$services.vfs.url("attach:Sandbox.WebHome@vma.txt.zip/vma.txt")]] | ||
| 66 | |||
| 67 | ## Display inline an image from a zip attached to a wiki page: | ||
| 68 | [[image:path:$services.vfs.url("attach:Sandbox.WebHome@test.zip/test.png")]] | ||
| 69 | |||
| 70 | ## Read the content of a file inside a zip attached to a page: | ||
| 71 | $stringtool.toString($niotool.readAllBytes("attach:Sandbox.WebHome@vma.txt.zip/vma.txt"), "utf-8") | ||
| 72 | |||
| 73 | ## List all entries inside a zip attached to a page: | ||
| 74 | #set ($dirStream = $niotool.newDirectoryStream("attach:Sandbox.WebHome@vma.txt.zip/")) | ||
| 75 | #foreach ($entry in $dirStream) | ||
| 76 | * {{{$entry}}} - $niotool.isDirectory($entry) | ||
| 77 | #end | ||
| 78 | {{/velocity}} | ||
| 79 | |||
| 80 | {{vfsTree root="attach:Sandbox.WebHome@vma.txt.zip/"/}} | ||
| 81 | {{/code}} | ||
| 82 | |||
| 83 | == Miscellaneous == | ||
| 84 | |||
| 85 | * [[WebJars URL format>>extensions:Extension.WebJars Integration||anchor="HURLFormat"]] now supports a ##wiki## query string parameter to specify the wiki in which the webjars resource is available. For example: {{code language="none"}}/xwiki/webjars/AjaxQ/0.0.2/ajaxq.js?wiki=mywiki{{/code}} | ||
| 86 | |||
| 87 | = Translations = | ||
| 88 | |||
| 89 | The following translations have been updated: | ||
| 90 | |||
| 91 | {{language codes="de, fr, zh"/}} | ||
| 92 | |||
| 93 | = Tested Browsers & Databases = | ||
| 94 | |||
| 95 | {{warning}} | ||
| 96 | The QA Tests are executed after the release has been done. Thus, they are being prepared now and will be published soon. | ||
| 97 | {{/warning}} | ||
| 98 | |||
| 99 | {{comment}} | ||
| 100 | TODO: uncomment and update with proper link when the report is ready. | ||
| 101 | {{include reference="TestReports.ManualTestReportTemplateSummary"/}} | ||
| 102 | {{/comment}} | ||
| 103 | |||
| 104 | = Known issues = | ||
| 105 | |||
| 106 | * [[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]] | ||
| 107 | |||
| 108 | = Backward Compatibility and Migration Notes = | ||
| 109 | |||
| 110 | == General Notes == | ||
| 111 | |||
| 112 | When upgrading make sure you compare your ##xwiki.cfg##, ##xwiki.properties## and ##web.xml## files with the newest version since some configuration parameters may have been modified or 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. | ||
| 113 | |||
| 114 | == API Breakages == | ||
| 115 | |||
| 116 | The following APIs were modified since <project> <version - 1>: | ||
| 117 | |||
| 118 | {{code language="none"}} | ||
| 119 | <clirr output here> | ||
| 120 | {{/code}} |
