From c82fbab028a27400b30514575c1ad4dfcb7af835 Mon Sep 17 00:00:00 2001 From: Ramkumar K Date: Wed, 31 Jul 2024 12:52:27 +0530 Subject: [PATCH] 6852-draft doc for loose applications-comm-inc-2 6852-draft doc for loose applications-comm-inc-2 #6852 --- modules/ROOT/pages/loose-applications.adoc | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/modules/ROOT/pages/loose-applications.adoc b/modules/ROOT/pages/loose-applications.adoc index a4c574bf9..98c1bd1c9 100644 --- a/modules/ROOT/pages/loose-applications.adoc +++ b/modules/ROOT/pages/loose-applications.adoc @@ -20,9 +20,9 @@ Normally an application is contained under one directory or in one archive, with == Loose application -A loose application is defined as a virtual directory that represents the application, where information can be located anywhere. It enables development tools to run applications where the related files are sourced directly from the workspace, bypassing the need for exporting. Such related files might be Java classes, JavaServer Pages, or images. Loading these files straight from the workspace leads to a quicker build-run-debug cycle. The content is not located in a single directory, but might originate from various locations. These locations are detailed in an XML configuration file. +A loose application is defined as a virtual directory that represents the application, where information can be located anywhere. Use of loose applications enables development tools to run applications where the related files are sourced directly from the workspace, bypassing the need for exporting. Such related files might be Java classes, JavaServer Pages, or images. Loading these files straight from the workspace leads to a quicker build-run-debug cycle. The content is not located in a single directory, but might originate from various locations. These locations are detailed in an XML configuration file. -The two ways to provide the XML file to the runtime are: +The two ways to provide the XML file to the Liberty server are: Using the location attribute:: Specify the XML file in the location attribute of the application configuration section, and make sure that the file name ends with `.xml`. If you specify ``, the runtime searches for a file named `myapp.war.xml`. However, if both `myapp.war` and `myapp.war.xml` exist, the Open Liberty server prioritizes `myapp.war` for running the application. The search rules for this method align with those of an application directory or an archive. @@ -30,12 +30,12 @@ Specify the XML file in the location attribute of the application configuration Using the application dropins folder:: Directly place the XML file into the application dropins folder, adhering to the folder naming conventions and appending `.xml` to the end of the file name. + -When you run the xref:server-package.adoc[server package] command with a loose application `my_app.war.xml` file that uses server variable substitution, those parts of the loose application having variable substitution are not packaged. The server is not started at the time of packaging and has no way to access the needed variable information. Variable substitution does not take place when you use the `server package` command . +When you run the xref:command/server-package.adoc[server package] command with a loose application `my_app.war.xml` file that uses server variable substitution, those parts of the loose application having variable substitution are not packaged. Variable substitution does not take place when you use the `server package` command. == Loose application configuration file -The Open Liberty server uses the loose application configuration file to obtain the application content, rather than locating it from a root directory or single archive. Using the appropriate XML, you can take the following actions: +When using a loose application, the Open Liberty server uses a loose application configuration to locate application content, rather than locating the application content from a root directory or root archive. You can use the loose application configuration to locate application content in the following ways: - Map any physical directory to any location within the application. - Map any physical file to any location within the application. @@ -44,7 +44,7 @@ The Open Liberty server uses the loose application configuration file to obtain For example: -- Map the root of the archive to one location on disk, such as a folder in an Eclipse project. +- Map the root of the virtual application archive to one location on disk, such as a folder in an Eclipse project. - Map a Java `bin/output` folder that is not in the **usual** location into the `WEB-INF/classes` folder. This location might be in a different folder due to your workspace preferences, corporate guidelines, source control project layout guidelines, and so on. You might have multiple Java source and output locations in the same project, and want to map them both to `WEB-INF/classes`. - Map an **external** `JAR` file into the application. This **external** `JAR` file might be one of the following: