From b9c49d7738d67b066bcf1381e97e1ab4592b45d3 Mon Sep 17 00:00:00 2001 From: Marc Schlegel Date: Thu, 11 Aug 2016 00:09:01 +0200 Subject: [PATCH] [PAXWEB-895] Updated Documentation --- pax-web-resources/Readme.md | 4 ++-- pax-web-resources/pax-web-resources-extender/Readme.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/pax-web-resources/Readme.md b/pax-web-resources/Readme.md index 4cdcb8c0cc..96cffd2352 100644 --- a/pax-web-resources/Readme.md +++ b/pax-web-resources/Readme.md @@ -12,11 +12,11 @@ This module enables Servlet 3.0 Resources for OSGi-Bundles. ## Beware the dynamics -Since resource-bundles, like every bundle in OSGi, can become unavailable, the implementation will block read-requests when the internal index is updated. This trade-off was made because usually the reads greatly outnumber the writes. +Since resource-bundles, like every bundle in OSGi, can become unavailable. ### Example with a unavailable resource When creating a HTML page, there are two phases: in the first, the HTML will be created and served to the browser. Here a resource-bundle is available and JSF can retrieve the resource-URL from the ResourceHandler. Now, the resource-bundle gets uninstalled. -During HTML-parsing, the browser will issue a dedicated resource-request with the given URL, but due to network-latency the resource-bundle has already gone. A webframework (like JSF) will try to open a stream to the given URL, in order to serve the actual bytes. This will cause an IOException because the resource under the given URL has vanished. +During HTML-parsing, the browser will issue a dedicated resource-request with the given URL, but due to network-latency the resource-bundle has already gone. A web-framework (like JSF) will try to open a stream to the given URL, in order to serve the actual bytes. This will cause an IOException because the resource under the given URL has vanished. diff --git a/pax-web-resources/pax-web-resources-extender/Readme.md b/pax-web-resources/pax-web-resources-extender/Readme.md index c4a8d29abd..dbe31fcde2 100644 --- a/pax-web-resources/pax-web-resources-extender/Readme.md +++ b/pax-web-resources/pax-web-resources-extender/Readme.md @@ -35,7 +35,7 @@ To do this, another implementation for `org.ops4j.pax.web.resource.api.OsgiResou 1. Create a separate bundle using the provided api-bundle 2. Just provide a additional service for `org.ops4j.pax.web.resource.api.OsgiResourceLocator` - The default implementation in this bundle registers a service with a ranking of -1. By registering a service without a ranking the framework will give it a ranking of 0 which will cause the custom implementation to be picked up - - This way, the exteder-pattern from this module is still active and will notify your custom-service about new and removed bundles. + - This way, the extender-pattern from this module is still active and will notify your custom-service about new and removed bundles.