http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/development/client-request-logging.html ---------------------------------------------------------------------- diff --git a/documentation/development/client-request-logging.html b/documentation/development/client-request-logging.html index ffca3c6..a3a3aa1 100644 --- a/documentation/development/client-request-logging.html +++ b/documentation/development/client-request-logging.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » </div> <h1> Client Request Logging - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>Sling provides extensive support to log various information at the before and after processing client requests. Out of the box, there are two loggers configured to write traditional <code>access.log</code> and <code>request.log</code> files. In addition more logging can be configured by providing OSGi Configuration Admin configuration.</p> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p>Sling provides extensive support to log various information at the before and after processing client requests. Out of the box, there are two loggers configured to write traditional <code>access.log</code> and <code>request.log</code> files. In addition more logging can be configured by providing OSGi Configuration Admin configuration.</p> <h2><a href="#traditional-access-log-and-request-log-files" name="traditional-access-log-and-request-log-files">Traditional access.log and request.log Files</a></h2> <p>In the Web Console configure the <em>Apache Sling Request Logger</em> (PID=<code>org.apache.sling.engine.impl.log.RequestLogger</code>) configuration.</p> <p>In the Sling Web Console locate the Configuration page (<code>/system/console/configMgr</code>) and click on the pencil (edit) symbol on the <em>Apache Sling Request Logger</em> line. This opens a dialog to enter the configuration whose properties can be configured as follows:</p>
http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/development/dependency-management.html ---------------------------------------------------------------------- diff --git a/documentation/development/dependency-management.html b/documentation/development/dependency-management.html index 75d44b1..3c0186d 100644 --- a/documentation/development/dependency-management.html +++ b/documentation/development/dependency-management.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » </div> <h1> Dependency Management - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>This page is about how we do and don't do dependency management in the Sling project.</p> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p>This page is about how we do and don't do dependency management in the Sling project.</p> <p><!-- TODO reactivate TOC once JBake moves to flexmark-java --> </p> <h2><a href="#introduction" name="introduction">Introduction</a></h2> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/development/embedding-sling.html ---------------------------------------------------------------------- diff --git a/documentation/development/embedding-sling.html b/documentation/development/embedding-sling.html index 708619f..bed4b11 100644 --- a/documentation/development/embedding-sling.html +++ b/documentation/development/embedding-sling.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » </div> <h1> Embedding Sling - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>The Sling Launchpad Launcher can be used to embed the OSGi Framework startup in your own Java application. This functionality is implemented in the <a href="http://svn.apache.org/repos/asf/sling/trunk/launchpad/base";>Sling Launchpad Base project</a>. This project has the following features:</p> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p>The Sling Launchpad Launcher can be used to embed the OSGi Framework startup in your own Java application. This functionality is implemented in the <a href="http://svn.apache.org/repos/asf/sling/trunk/launchpad/base";>Sling Launchpad Base project</a>. This project has the following features:</p> <ul> <li>Builds three artifacts: <ul> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/development/getting-and-building-sling.html ---------------------------------------------------------------------- diff --git a/documentation/development/getting-and-building-sling.html b/documentation/development/getting-and-building-sling.html index 2da9c8d..0e24ab1 100644 --- a/documentation/development/getting-and-building-sling.html +++ b/documentation/development/getting-and-building-sling.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » </div> <h1> Getting and Building Sling - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>A quick guide for getting the Sling source, then building and running the resulting Sling instance; either without or with Eclipse.</p> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p>A quick guide for getting the Sling source, then building and running the resulting Sling instance; either without or with Eclipse.</p> <p>Note that you don't <em>have</em> to build Sling yourself, if you don't need the bleeding-edge stuff you can get prebuilt binaries from the <a href="/downloads.cgi">Downloads</a> page. But those, especially the launchpad runnable jar, are not released often and can be outdated. In case of doubt, build it yourself as shown below or ask on the Sling users mailing list.</p> <p>Rather than performing a full build of Sling, which can take 5-10 minutes on a recent computer once your local Maven repository is up to date, it's recommended to build only the launchpad and the modules you're interested in.</p> <h2><a href="#tl-dr-short-form-build-run-instructions" name="tl-dr-short-form-build-run-instructions">tl:dr - Short form build + run instructions</a></h2> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/development/hamcrest.html ---------------------------------------------------------------------- diff --git a/documentation/development/hamcrest.html b/documentation/development/hamcrest.html index f2ac18b..c221fec 100644 --- a/documentation/development/hamcrest.html +++ b/documentation/development/hamcrest.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » </div> <h1> Hamcrest Integration - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>Deeper integration with the <a href="http://hamcrest.org/";>Hamcrest matcher library</a>.</p> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p>Deeper integration with the <a href="http://hamcrest.org/";>Hamcrest matcher library</a>.</p> <h2><a href="#maven-dependency" name="maven-dependency">Maven Dependency</a></h2> <div class="warning"> This module has not yet been officially released. http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/development/htl-maven-plugin.html ---------------------------------------------------------------------- diff --git a/documentation/development/htl-maven-plugin.html b/documentation/development/htl-maven-plugin.html index a9a3352..8fbadaf 100644 --- a/documentation/development/htl-maven-plugin.html +++ b/documentation/development/htl-maven-plugin.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » </div> <h1> HTL Maven Plugin - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>See <a href="http://sling.apache.org/components/htl-maven-plugin/";>Apache Sling HTL Maven Plugin documentation</a>.</p></section></div></div> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p>See <a href="http://sling.apache.org/components/htl-maven-plugin/";>Apache Sling HTL Maven Plugin documentation</a>.</p></section></div></div> <div class="footer"> <div class="trademarkFooter"> Apache Sling, Sling, Apache, the Apache feather logo, and the Apache Sling project logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners. http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/development/ide-tooling.html ---------------------------------------------------------------------- diff --git a/documentation/development/ide-tooling.html b/documentation/development/ide-tooling.html index a081fa5..1634a49 100644 --- a/documentation/development/ide-tooling.html +++ b/documentation/development/ide-tooling.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » </div> <h1> Sling IDE tooling for Eclipse User Guide - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p><!-- TODO reactivate TOC once JBake moves to flexmark-java --> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p><!-- TODO reactivate TOC once JBake moves to flexmark-java --> </p> <h2><a href="#installation" name="installation">Installation</a></h2> <h3><a href="#prerequisites" name="prerequisites">Prerequisites</a></h3> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/development/ide-tooling/ide-tooling-incremental-build.html ---------------------------------------------------------------------- diff --git a/documentation/development/ide-tooling/ide-tooling-incremental-build.html b/documentation/development/ide-tooling/ide-tooling-incremental-build.html index 12d1c08..4a2e70a 100644 --- a/documentation/development/ide-tooling/ide-tooling-incremental-build.html +++ b/documentation/development/ide-tooling/ide-tooling-incremental-build.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » <a href="/ng/documentation/development/ide-tooling.html">Sling IDE tooling for Eclipse User Guide</a> » </div> <h1> Incremental Builds in Sling IDE tooling for Eclipse - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p><!-- TODO reactivate TOC once JBake moves to flexmark-java --> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p><!-- TODO reactivate TOC once JBake moves to flexmark-java --> </p> <h2><a href="#overview" name="overview">Overview</a></h2> <p>The Sling IDE Tooling relies on the <a href="https://wiki.eclipse.org/M2E_compatible_maven_plugins";>m2e incremental build support</a> for the generation of the bundle's manifest, the component descriptions as well as the metatype resources (the latter two being generated through OSGi 6 <a href="https://osgi.org/javadoc/r6/cmpn/org/osgi/service/component/annotations/package-summary.html";>component annotations</a> and <a href="https://osgi.org/javadoc/r6/cmpn/org/osgi/service/metatype/annotations/package-summary.html";>metatype annotations</a> or through <a href="http://felix.apache.org/documentation/subprojects/apache-felix-maven-scr-plugin/scr-annotations.html";>Apache Felix SCR annotations</a>). That means whenever at least one java class is touched and the auto-build in Eclipse is enabled the annotations on that class should be reevaluated. This may lead to a modification of the bundle's manifest and/or generation/modification of service description XMLs and/or Metatype resource files. Depending on which maven plugins you use you must adjust their configuration accordingly to properly support incremental builds.</p> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/development/issue-tracker.html ---------------------------------------------------------------------- diff --git a/documentation/development/issue-tracker.html b/documentation/development/issue-tracker.html index 6b40ad0..e16f0e1 100644 --- a/documentation/development/issue-tracker.html +++ b/documentation/development/issue-tracker.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » </div> <h1> Issue Tracker - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>Apache Sling uses Jira for tracking bug reports and requests for improvements, new features, and other changes.</p> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p>Apache Sling uses Jira for tracking bug reports and requests for improvements, new features, and other changes.</p> <p>The issue tracker is available at <a href="https://issues.apache.org/jira/browse/SLING";>https://issues.apache.org/jira/browse/SLING</a> and is readable by everyone. A Jira account is needed to create new issues and to comment on existing issues. Use the <a href="https://issues.apache.org/jira/secure/Signup!default.jspa";>registration form</a> to request an account if you do not already have one.</p> <p>See below for guidelines on creating and managing issues.</p> <h2><a href="#issue-type" name="issue-type">Issue type</a></h2> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/development/jcr-mock.html ---------------------------------------------------------------------- diff --git a/documentation/development/jcr-mock.html b/documentation/development/jcr-mock.html index 852080f..95a496c 100644 --- a/documentation/development/jcr-mock.html +++ b/documentation/development/jcr-mock.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » </div> <h1> JCR Mocks - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>Mock implementation of selected JCR APIs for easier testing. It stores all data in-memory in a HashMap to ensure instantly creating and destroying of the JCR repository.</p> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p>Mock implementation of selected JCR APIs for easier testing. It stores all data in-memory in a HashMap to ensure instantly creating and destroying of the JCR repository.</p> <p><!-- TODO reactivate TOC once JBake moves to flexmark-java --> </p> <h2><a href="#maven-dependency" name="maven-dependency">Maven Dependency</a></h2> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/development/jspc.html ---------------------------------------------------------------------- diff --git a/documentation/development/jspc.html b/documentation/development/jspc.html index c126d3b..276bff9 100644 --- a/documentation/development/jspc.html +++ b/documentation/development/jspc.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » </div> <h1> HTL Maven Plugin - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>See <a href="http://sling.apache.org/components/jspc-maven-plugin/";>Apache Sling JspC Maven Plugin documentation</a>.</p></section></div></div> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p>See <a href="http://sling.apache.org/components/jspc-maven-plugin/";>Apache Sling JspC Maven Plugin documentation</a>.</p></section></div></div> <div class="footer"> <div class="trademarkFooter"> Apache Sling, Sling, Apache, the Apache feather logo, and the Apache Sling project logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners. http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/development/jsr-305.html ---------------------------------------------------------------------- diff --git a/documentation/development/jsr-305.html b/documentation/development/jsr-305.html index 3c40446..54a0897 100644 --- a/documentation/development/jsr-305.html +++ b/documentation/development/jsr-305.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » </div> <h1> Leveraging JSR-305 null annotations to prevent NullPointerExceptions - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p><!-- TODO reactivate TOC once JBake moves to flexmark-java --> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p><!-- TODO reactivate TOC once JBake moves to flexmark-java --> </p> <h1><a href="#introduction" name="introduction">Introduction</a></h1> <p>The Sling API forces developers to sometimes check for <code>null</code> return values. Most prominently this is the case for <a href="https://sling.apache.org/apidocs/sling8/org/apache/sling/api/adapter/Adaptable.html#adaptTo-java.lang.Class-";><code>Adaptable.adaptTo</code></a> and <a href="https://sling.apache.org/apidocs/sling8/org/apache/sling/api/resource/ResourceResolver.html#getResource-java.lang.String-";><code>ResourceResolver.getResource</code></a>. This is often forgotten, which may lead to <code>NullPointerException</code>s. Sling API 2.9.0 introduced the JSR-305 annotations (<a href="https://issues.apache.org/jira/browse/SLING-4377";>SLING-4377</a>) which allow tools to check automatically for missing null checks in the code.</p> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/development/logging.html ---------------------------------------------------------------------- diff --git a/documentation/development/logging.html b/documentation/development/logging.html index 574d139..cca41e3 100644 --- a/documentation/development/logging.html +++ b/documentation/development/logging.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » </div> <h1> Logging - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><div class="note"> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><div class="note"> This document is for the new (November 2013) 4.x release of the Sling Commons Log components. Refer to <a href="http://sling.apache.org/documentation/legacy/logging.html";>Logging 3.x</a> for older versions. </div> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/development/maven-archetypes.html ---------------------------------------------------------------------- diff --git a/documentation/development/maven-archetypes.html b/documentation/development/maven-archetypes.html index 589be57..24d8893 100644 --- a/documentation/development/maven-archetypes.html +++ b/documentation/development/maven-archetypes.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » </div> <h1> Maven Archetypes - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>Sling includes four Maven archetypes to quick start development. See <a href="http://maven.apache.org/archetype/maven-archetype-plugin/";>http://maven.apache.org/archetype/maven-archetype-plugin/</a> for general information on using Maven archetypes. The Maven groupId for all Sling archetypes is <code>org.apache.sling</code>.</p> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p>Sling includes four Maven archetypes to quick start development. See <a href="http://maven.apache.org/archetype/maven-archetype-plugin/";>http://maven.apache.org/archetype/maven-archetype-plugin/</a> for general information on using Maven archetypes. The Maven groupId for all Sling archetypes is <code>org.apache.sling</code>.</p> <h3><a href="#sling-launchpad-standalone-archetype" name="sling-launchpad-standalone-archetype">sling-launchpad-standalone-archetype</a></h3> <p>This archetype generates a Maven project which will build a standalone Launchpad JAR file using the default bundle set. For demonstration purposes, the generated project includes an extra bundle list file (<code>src/main/bundles/list</code>) which includes Apache Felix FileInstall as well as a test configuration file (<code>src/test/config/sling.properties</code>).</p> <h3><a href="#sling-launchpad-webapp-archetype" name="sling-launchpad-webapp-archetype">sling-launchpad-webapp-archetype</a></h3> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/development/maven-launchpad-plugin.html ---------------------------------------------------------------------- diff --git a/documentation/development/maven-launchpad-plugin.html b/documentation/development/maven-launchpad-plugin.html index e57ee1f..9eb3dcb 100644 --- a/documentation/development/maven-launchpad-plugin.html +++ b/documentation/development/maven-launchpad-plugin.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » </div> <h1> Maven Launchpad Plugin - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><div class="note"> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><div class="note"> This page is out of sync with the latest maven-launchpad-plugin features and settings. For now, refer to the source code and the launchpad/builder and launchpad/testing modules for more information. </div> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/development/maven-usage.html ---------------------------------------------------------------------- diff --git a/documentation/development/maven-usage.html b/documentation/development/maven-usage.html index 6a6463b..0046d81 100644 --- a/documentation/development/maven-usage.html +++ b/documentation/development/maven-usage.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » </div> <h1> Maven Usage - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>Apache Sling uses Maven as a build tool. This page documents some of the choices that we made when using Maven.</p> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p>Apache Sling uses Maven as a build tool. This page documents some of the choices that we made when using Maven.</p> <h2><a href="#parent-pom" name="parent-pom">Parent POM</a></h2> <p>We separate the reactor POM from the parent POM. While the reactor POM functions as a simple aggregator, the parent POM, currently located at <a href="http://svn.apache.org/repos/asf/sling/trunk/parent/pom.xml";>parent/pom.xml</a>, holds the common build configuration for all modules.</p> <p>The reference to the parent POM is usually set to a released version since we don't deploy it as a SNAPSHOT during the build process. That reference must also contain an empty parentPath element, otherwise recent version of Maven will try to find it in the local filesystem, disregarding the version if the groupId and artifactId match. An example of how to reference the parent POM is</p> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/development/maventipsandtricks.html ---------------------------------------------------------------------- diff --git a/documentation/development/maventipsandtricks.html b/documentation/development/maventipsandtricks.html index 0e78e45..89cd417 100644 --- a/documentation/development/maventipsandtricks.html +++ b/documentation/development/maventipsandtricks.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » </div> <h1> MavenTipsAndTricks - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>Here's our collection of tips and tricks for building Sling with <a href="http://maven.apache.org";>Maven</a>.</p> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p>Here's our collection of tips and tricks for building Sling with <a href="http://maven.apache.org";>Maven</a>.</p> <h1><a href="#maven-local-repository" name="maven-local-repository">Maven local repository</a></h1> <p>The first time you run a Maven build, or when Maven needs additional build components, it downloads plugins and dependencies under its <em>local repository</em> folder on your computer. By default, this folder is named <em>.m2/repository</em> in your home directory.</p> <p>Maven uses this repository as a cache for artifacts that it might need for future builds, which means that the first Sling build usually takes much longer than usual, as Maven needs to download many tools and dependencies into its local repository while the build progresses.</p> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/development/monitoring-requests.html ---------------------------------------------------------------------- diff --git a/documentation/development/monitoring-requests.html b/documentation/development/monitoring-requests.html index 88c57cb..3dacd6a 100644 --- a/documentation/development/monitoring-requests.html +++ b/documentation/development/monitoring-requests.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » </div> <h1> Monitoring Requests - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>Sling provides a simple OSGi console plugin to monitor recent requests. This is quite useful when debugging and to understand how things work, though it's obviously not a replacement for full-blown HTTP trafic monitoring tools.</p> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p>Sling provides a simple OSGi console plugin to monitor recent requests. This is quite useful when debugging and to understand how things work, though it's obviously not a replacement for full-blown HTTP trafic monitoring tools.</p> <p>The console plugin is available at /system/console/requests, listed as <em>Recent Requests</em> in the console menu.</p> <p>The plugin keeps track of the latest 20 requests processed by Sling, and displays the information provided by the RequestProgressTracker, for the selected request. The screenshot below shows an example.</p> <p>Any information that's added to the RequestProgressTracker (which is available from the SlingHttpServletRequest object) during request processing will be displayed by this plugin.</p> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/development/osgi-mock.html ---------------------------------------------------------------------- diff --git a/documentation/development/osgi-mock.html b/documentation/development/osgi-mock.html index 9bc710b..9c5416b 100644 --- a/documentation/development/osgi-mock.html +++ b/documentation/development/osgi-mock.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » </div> <h1> OSGi Mocks - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>Mock implementation of selected OSGi APIs for easier testing.</p> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p>Mock implementation of selected OSGi APIs for easier testing.</p> <p><!-- TODO reactivate TOC once JBake moves to flexmark-java --> </p> <h2><a href="#maven-dependency" name="maven-dependency">Maven Dependency</a></h2> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/development/release-management.html ---------------------------------------------------------------------- diff --git a/documentation/development/release-management.html b/documentation/development/release-management.html index f5b931e..29a875f 100644 --- a/documentation/development/release-management.html +++ b/documentation/development/release-management.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » </div> <h1> Release Management - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>Sling releases (and SNAPSHOTS) are deployed to the <a href="http://repository.apache.org";>Nexus repository</a> instead of the traditional deployment via the Maven 2 mirrors source on <code>people.apache.org</code>. This makes the release process much leaner and simpler. In addtion we can benefit from the Apache Parent POM 6, which has most of the release profile setup built-in.</p> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p>Sling releases (and SNAPSHOTS) are deployed to the <a href="http://repository.apache.org";>Nexus repository</a> instead of the traditional deployment via the Maven 2 mirrors source on <code>people.apache.org</code>. This makes the release process much leaner and simpler. In addtion we can benefit from the Apache Parent POM 6, which has most of the release profile setup built-in.</p> <p>Most of the hard work of preparing and deploying the release is done by Maven.</p> <p><!-- TODO reactivate TOC once JBake moves to flexmark-java --> </p> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/development/repository-based-development.html ---------------------------------------------------------------------- diff --git a/documentation/development/repository-based-development.html b/documentation/development/repository-based-development.html index 06b5c12..cbda575 100644 --- a/documentation/development/repository-based-development.html +++ b/documentation/development/repository-based-development.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » </div> <h1> Repository Based Development - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p><!-- TODO reactivate TOC once JBake moves to flexmark-java --> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p><!-- TODO reactivate TOC once JBake moves to flexmark-java --> </p> <h1><a href="#webdav-support" name="webdav-support">WebDAV Support</a></h1> <p>WebDAV support in Sling is based on the <a href="http://jackrabbit.apache.org/jcr/components/jackrabbit-jcr-server.html#Simple_Webdav_Server";>Simple WebDAV</a> implementation of Apache Jackrabbit which is integrated in the <code>jcr/webdav</code> project. This bundle provides WebDAV access to Sling's repository in two flavours: </p> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/development/resourceresolver-mock.html ---------------------------------------------------------------------- diff --git a/documentation/development/resourceresolver-mock.html b/documentation/development/resourceresolver-mock.html index ca5bca0..0936035 100644 --- a/documentation/development/resourceresolver-mock.html +++ b/documentation/development/resourceresolver-mock.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » </div> <h1> Resource Resolver Mock - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>Mock for the resource resolver / factory for easier testing. It uses an in-memory map for storing the resource data, and supports reading, writing and a certain level of transaction and eventing support.</p> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p>Mock for the resource resolver / factory for easier testing. It uses an in-memory map for storing the resource data, and supports reading, writing and a certain level of transaction and eventing support.</p> <p><!-- TODO reactivate TOC once JBake moves to flexmark-java --> </p> <h2><a href="#maven-dependency" name="maven-dependency">Maven Dependency</a></h2> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/development/sling-mock.html ---------------------------------------------------------------------- diff --git a/documentation/development/sling-mock.html b/documentation/development/sling-mock.html index 927cb2e..c62dbe8 100644 --- a/documentation/development/sling-mock.html +++ b/documentation/development/sling-mock.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » <a href="/ng/documentation/development/sling.html">Maven Sling Plugin</a> » </div> <h1> Sling Mocks - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>Mock implementation of selected Sling APIs for easier testing.</p> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p>Mock implementation of selected Sling APIs for easier testing.</p> <p><!-- TODO reactivate TOC once JBake moves to flexmark-java --> </p> <h2><a href="#maven-dependency" name="maven-dependency">Maven Dependency</a></h2> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/development/sling-testing-tools.html ---------------------------------------------------------------------- diff --git a/documentation/development/sling-testing-tools.html b/documentation/development/sling-testing-tools.html index 0d5deff..a4d246d 100644 --- a/documentation/development/sling-testing-tools.html +++ b/documentation/development/sling-testing-tools.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » <a href="/ng/documentation/development/sling.html">Maven Sling Plugin</a> » </div> <h1> Sling Testing Tools - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><div class="warning"> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><div class="warning"> While this information is still valid, we recommend using the tools and techniques described in the newer "Junit Server-Side Tests Support" page instead, see link below. </div> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/development/sling.html ---------------------------------------------------------------------- diff --git a/documentation/development/sling.html b/documentation/development/sling.html index 81d4d35..04bcfb7 100644 --- a/documentation/development/sling.html +++ b/documentation/development/sling.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » </div> <h1> Maven Sling Plugin - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>See <a href="http://sling.apache.org/components/maven-sling-plugin/";>Apache Maven Sling Plugin documentation</a>.</p></section></div></div> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p>See <a href="http://sling.apache.org/components/maven-sling-plugin/";>Apache Maven Sling Plugin documentation</a>.</p></section></div></div> <div class="footer"> <div class="trademarkFooter"> Apache Sling, Sling, Apache, the Apache feather logo, and the Apache Sling project logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners. http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/development/slingstart.html ---------------------------------------------------------------------- diff --git a/documentation/development/slingstart.html b/documentation/development/slingstart.html index c9c96be..98a4fcd 100644 --- a/documentation/development/slingstart.html +++ b/documentation/development/slingstart.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » <a href="/ng/documentation/development/sling.html">Maven Sling Plugin</a> » </div> <h1> The Apache Sling Provisioning Model and Apache SlingStart - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p><!-- TODO reactivate TOC once JBake moves to flexmark-java --> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p><!-- TODO reactivate TOC once JBake moves to flexmark-java --> </p> <p>The Apache Sling provisioning model is a model to describe OSGi based application. It can also be used to define a partial application aka feature (or subsystem in OSGi terms).</p> <p>The model is describing an instance, it is not directly related to any particular tooling or packaging/provisioning vehicle.</p> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/development/version-policy.html ---------------------------------------------------------------------- diff --git a/documentation/development/version-policy.html b/documentation/development/version-policy.html index d402cd9..e9a1c74 100644 --- a/documentation/development/version-policy.html +++ b/documentation/development/version-policy.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » </div> <h1> Version Policy - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>This page is about how we assign versions to exported packages and bundles and defines when to increase which part of the version number.</p> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p>This page is about how we assign versions to exported packages and bundles and defines when to increase which part of the version number.</p> <div class="info"> Please note that this page is currently in draft stage and still being discussed. </div> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/getting-started.html ---------------------------------------------------------------------- diff --git a/documentation/getting-started.html b/documentation/getting-started.html index 7ad4fd6..9fbf8f2 100644 --- a/documentation/getting-started.html +++ b/documentation/getting-started.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » </div> <h1> Getting Started - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>We're on the way to update the documentation to make it more easy to get in touch with Sling. At the moment we can give you the following starting points:</p> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p>We're on the way to update the documentation to make it more easy to get in touch with Sling. At the moment we can give you the following starting points:</p> <ul> <li><a href="getting-started/discover-sling-in-15-minutes.html">Discover Sling in 15 minutes</a></li> </ul> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/getting-started/discover-sling-in-15-minutes.html ---------------------------------------------------------------------- diff --git a/documentation/getting-started/discover-sling-in-15-minutes.html b/documentation/getting-started/discover-sling-in-15-minutes.html index 5a6073d..47153b8 100644 --- a/documentation/getting-started/discover-sling-in-15-minutes.html +++ b/documentation/getting-started/discover-sling-in-15-minutes.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/getting-started.html">Getting Started</a> » </div> <h1> Discover Sling in 15 minutes - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>The Sling Launchpad is a ready-to-run Sling configuration, providing an embedded JCR content repository and web server, a selection of Sling components, documentation and examples. The Launchpad makes it easy to get started with Sling and to develop script-based applications.</p> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p>The Sling Launchpad is a ready-to-run Sling configuration, providing an embedded JCR content repository and web server, a selection of Sling components, documentation and examples. The Launchpad makes it easy to get started with Sling and to develop script-based applications.</p> <p>This page will help you get started with the Launchpad. Fifteen minutes should be enough to get an overview of what Sling does.</p> <p>While simple to run and understand, the Launchpad is a full-featured instance of Sling, an example configuration that we have created with the most common modules and configurations. The full functionality of Sling is available by loading additional Sling (or custom) OSGi bundles as needed, using the Launchpad's web-based OSGi management console.</p> <p><!-- TODO reactivate TOC once JBake moves to flexmark-java --> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/legacy/logging.html ---------------------------------------------------------------------- diff --git a/documentation/legacy/logging.html b/documentation/legacy/logging.html index 2e9a877..90ae82a 100644 --- a/documentation/legacy/logging.html +++ b/documentation/legacy/logging.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » </div> <h1> Logging - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><div class="note"> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><div class="note"> This document is for 3.x release of Sling Commons Log components. Refer to <a href="http://sling.apache.org/documentation/development/logging.html";>Logging</a> for documentation related to newer version. http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/pax-exam-utils.html ---------------------------------------------------------------------- diff --git a/documentation/pax-exam-utils.html b/documentation/pax-exam-utils.html index f30db6d..2605de2 100644 --- a/documentation/pax-exam-utils.html +++ b/documentation/pax-exam-utils.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » </div> <h1> Sling Pax Exam Utilities - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>Utilities to help testing Sling components with Pax Exam are available at <a href="https://svn.apache.org/repos/asf/sling/trunk/testing/sling-pax-util";>https://svn.apache.org/repos/asf/sling/trunk/testing/sling-pax-util</a></p> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p>Utilities to help testing Sling components with Pax Exam are available at <a href="https://svn.apache.org/repos/asf/sling/trunk/testing/sling-pax-util";>https://svn.apache.org/repos/asf/sling/trunk/testing/sling-pax-util</a></p> <p>The focus is on making it easier to test Sling components against a full Sling launchpad, with minimal boilerplate code.</p> <p>See the <a href="https://svn.apache.org/repos/asf/sling/trunk/testing/sling-pax-util/src/test/java/org/apache/sling/paxexam/util/SlingRepositoryTest.java";>SlingRepositoryTest</a> class for an example test.</p></section></div></div> <div class="footer"> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/the-sling-engine.html ---------------------------------------------------------------------- diff --git a/documentation/the-sling-engine.html b/documentation/the-sling-engine.html index 5794379..dd8f2dc 100644 --- a/documentation/the-sling-engine.html +++ b/documentation/the-sling-engine.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » </div> <h1> The Sling Engine - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><h2><a href="#general" name="general">General</a></h2> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><h2><a href="#general" name="general">General</a></h2> <ul> <li><a href="/documentation/the-sling-engine/architecture.html">Architecture</a></li> <li><a href="/documentation/the-sling-engine/authentication.html">Authentication</a></li> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/the-sling-engine/adapters.html ---------------------------------------------------------------------- diff --git a/documentation/the-sling-engine/adapters.html b/documentation/the-sling-engine/adapters.html index aec3d2a..0560e4b 100644 --- a/documentation/the-sling-engine/adapters.html +++ b/documentation/the-sling-engine/adapters.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/the-sling-engine.html">The Sling Engine</a> » </div> <h1> Adapters - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p><!-- TODO reactivate TOC once JBake moves to flexmark-java --> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p><!-- TODO reactivate TOC once JBake moves to flexmark-java --> </p> <p>The <code>Resource</code> and <code>ResourceResolver</code> interfaces are defined with a method <code>adaptTo</code>, which adapts the object to other classes. Using this mechanism the JCR session of the resource resolver calling the <code>adaptTo</code> method with the <code>javax.jcr.Session</code> class object. Likewise the JCR node on which a resource is based can be retrieved by calling the <code>Resource.adaptTo</code> method with the <code>javax.jcr.Node</code> class object.</p> <p>To use resources as scripts, the <code>Resource.adaptTo</code> method must support being called with the <code>org.apache.sling.api.script.SlingScript</code> class object. But of course, we do not want to integrate the script manager with the resource resolver. To enable adapting objects to classes which are not foreseen by the original implementation, a factory mechanism is used. This way, the script manager can provide an adapter factory to adapt <code>Resource</code> to <code>SlingScript</code> objects.</p> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/the-sling-engine/architecture.html ---------------------------------------------------------------------- diff --git a/documentation/the-sling-engine/architecture.html b/documentation/the-sling-engine/architecture.html index 7a0175a..0f5b0d8 100644 --- a/documentation/the-sling-engine/architecture.html +++ b/documentation/the-sling-engine/architecture.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/the-sling-engine.html">The Sling Engine</a> » </div> <h1> Architecture - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>The following is a short list of high-lights of Sling:</p> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p>The following is a short list of high-lights of Sling:</p> <ul> <li><strong><a href="#osgi">OSGi</a></strong> — The Sling application is built as a series of OSGi bundles and makes heavy use of a number of OSGi core and compendium services.</li> <li><strong><a href="#sling-api">Sling API</a></strong> — To implement content based Web applications with Sling, an API has been defined, this extends the Servlet API and provides more functionality to work on the content.</li> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/the-sling-engine/authentication.html ---------------------------------------------------------------------- diff --git a/documentation/the-sling-engine/authentication.html b/documentation/the-sling-engine/authentication.html index d23346e..501b653 100644 --- a/documentation/the-sling-engine/authentication.html +++ b/documentation/the-sling-engine/authentication.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/the-sling-engine.html">The Sling Engine</a> » </div> <h1> Authentication - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>This section describes the framework provided by Sling to authenticate HTTP requests.</p> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p>This section describes the framework provided by Sling to authenticate HTTP requests.</p> <p>Let's look at generic request processing of Sling: Sling is linked into the outside world by registering the Sling Main Servlet – implemented by the <code>SlingMainServlet</code> class in the Sling Engine bundle – with an OSGi <code>HttpService</code>. This registration is accompanyied with an implementation instance of the OSGi <code>HttpContext</code> interface, which defines a method to authenticate requests: <code>handleSecurity</code>.</p> <p>This method is called by the OSGi HTTP Service implementation after the servlet has been selected to handle the request but before actually calling the servlet's <code>service</code> method.</p> <a href="authentication.png" style="float:left;padding-right:5%"> http://git-wip-us.apache.org/repos/asf/sling-site/blob/d1705814/documentation/the-sling-engine/authentication/authentication-actors.html ---------------------------------------------------------------------- diff --git a/documentation/the-sling-engine/authentication/authentication-actors.html b/documentation/the-sling-engine/authentication/authentication-actors.html index e8035bb..86247ba 100644 --- a/documentation/the-sling-engine/authentication/authentication-actors.html +++ b/documentation/the-sling-engine/authentication/authentication-actors.html @@ -20,7 +20,7 @@ <img border="0" alt="Apache" src="/ng/res/logos/apache.png"/> </a> </div> - </div><h1 class="draft">DRAFT 2017 WEBSITE - SLING-6955</h1><div class="menu"> + </div><div class="draft">DRAFT 2017 WEBSITE - SLING-6955</div><div class="menu"> <p> <strong><a href="/ng/documentation.html">Documentation</a></strong><br/> <a href="/ng/documentation/getting-started.html">Getting Started</a><br/> @@ -72,7 +72,7 @@ </div> <div class="main"> <div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/the-sling-engine.html">The Sling Engine</a> » <a href="/ng/documentation/the-sling-engine/authentication.html">Authentication</a> » </div> <h1> Authentication - Actors - </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>The authentication process involves a number of actors contributing to the concepts, the API and the particular implementations.</p> + </h1><div id="generatedToC"></div><script src='/res/jquery-3.2.1.min.js' type='text/javascript'></script><script src='/res/tocjs-1-1-2.js' type='text/javascript'></script><script type='text/javascript'>$(document).ready(function() { $('#generatedToC').toc({'selector':'h2,h3'}); } );</script><div class="row"><div class="small-12 columns"><section class="wrap"><p>The authentication process involves a number of actors contributing to the concepts, the API and the particular implementations.</p> <h2><a href="#osgi-http-service-specification" name="osgi-http-service-specification">OSGi Http Service Specification</a></h2> <p>The main support for authentication is defined by the OSGi Http Service specification. This specification defines how an OSGi application can register servlets and resources to build web applications. As part of the servlet and/or resource registration a <code>HttpContext</code> may be provided, which allows for additional support.</p> <p>The main method of interest to the authentication process is the <code>handleSecurity</code> method. This is called by the OSGi Http Service implementation before the registered servlet is called. Its intent is to authenticate the request and to provide authentication information for the request object: the authentication type and the remote user name.</p>
