Wiki source code of XWiki API Reference
Version 455.3 by Vincent Massol on 2015/03/16
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{velocity}} | ||
| 2 | #set($versionStable = "6.4.2") | ||
| 3 | #set($nameStable = $versionStable) | ||
| 4 | #set($versionDev = "7.0-milestone-2") | ||
| 5 | #set($nameDev = "7.0 Milestone 2") | ||
| 6 | ##set($versionOldStable = "5.4.7") | ||
| 7 | ##set($nameOldStable = $versionOldStable) | ||
| 8 | |||
| 9 | #macro(coreJavadocUrl $version) | ||
| 10 | http://nexus.xwiki.org/nexus/service/local/repositories/releases/archive/org/xwiki/platform/xwiki-platform-oldcore/${version}/xwiki-platform-oldcore-${version}-javadoc.jar/!/index.html | ||
| 11 | #end | ||
| 12 | #macro(renderingJavadocUrl $version) | ||
| 13 | http://nexus.xwiki.org/nexus/service/local/repositories/releases/archive/org/xwiki/rendering/xwiki-rendering-api/${version}/xwiki-rendering-api-${version}-javadoc.jar/!/index.html | ||
| 14 | #end | ||
| 15 | {{/velocity}} | ||
| 16 | |||
| 17 | XWiki's APIs are the methods that the XWiki development team consider safe for you to use (i.e. for which backward compatibility is guaranteed). They can be called from Java or directly from your wiki pages [[using a scripting language>>DevGuide.Scripting]] (Velocity, Groovy, Python, Ruby, etc). | ||
| 18 | |||
| 19 | {{info}} | ||
| 20 | As users of the XWiki API you need to be aware of some important points: | ||
| 21 | * You should never use a class having ##internal## in its package. It means this class is not a public API and XWiki developers can change it at any time. If you depend on such a class you're on your own and the XWiki Development Team doesn't guarantee its stability. | ||
| 22 | * You should pay attention to the ##@Unstable## annotation. When you see code marked with this annotation it means it's a new public API that it still considered unstable and that can change at any time too. See [[Unstable Annotation>>dev:Community.DevelopmentPractices||anchor="H40UnstableAnnotation"]] for more details. | ||
| 23 | {{/info}} | ||
| 24 | |||
| 25 | == Scripting Reference Documentation == | ||
| 26 | |||
| 27 | * For XWiki versions >= 6.2.5+ you should install the [[Scripting Documentation Application>>extensions:Extension.Scripting Documentation Application]] in your wiki. You can [[browse a version of it installed on xwiki.org>>ScriptingDocumentation.WebHome]] (but beware, it'll show the Scripting API available on the XWiki version installed for xwiki.org, which may differ from your locally installed XWiki version). | ||
| 28 | * For XWiki versions <= 5.0.x you can browse the old [[Scripting Reference Documentation>>SRD.Navigation||queryString="xpage=embed"]] (a.k.a SRD). | ||
| 29 | |||
| 30 | == How to find a class == | ||
| 31 | |||
| 32 | You can get the maven module where to find a Java class by using [[XWiki Nexus Search page>>http://nexus.xwiki.org/nexus/index.html#nexus-search;classname~~]]. Put the complete class name and you will get all modules containing it. Nexus also allows you to see what's in those artifacts and read the javadoc. | ||
| 33 | |||
| 34 | == Other documentations == | ||
| 35 | |||
| 36 | The latest API documentation is available as JavaDoc: | ||
| 37 | |||
| 38 | {{velocity}} | ||
| 39 | * [[Javadoc for XWiki Platform Core - $nameStable>>#coreJavadocUrl($versionStable)]] (stable) | ||
| 40 | #if ($versionDev) | ||
| 41 | * [[Javadoc for XWiki Platform Core - $nameDev>>#coreJavadocUrl($versionDev)]] (dev) | ||
| 42 | #end | ||
| 43 | #if ($versionOldStable) | ||
| 44 | * [[Javadoc for XWiki Platform Core - $nameOldStable>>#coreJavadocUrl($versionOldStable)]] (super stable)#end | ||
| 45 | {{/velocity}} | ||
| 46 | |||
| 47 | * [[Full Javadoc>>http://maven.xwiki.org/site/docs/]] | ||
| 48 | |||
| 49 | You might also be interested in the [[Rendering Engine API JavaDoc>>rendering:Main.JavaDoc]]. | ||
| 50 | |||
| 51 | Older Javadocs of XWiki can be found in our [[Maven Release repository>>http://maven.xwiki.org/releases/]]. For example for XWiki Platform Core Javadocs, check the files suffixed by ##javadoc## for the version you wish under [[this directory>>http://maven.xwiki.org/releases/org/xwiki/platform/xwiki-platform-oldcore/]]. |
