org/apache/sis/util/logging/Initializer.html - sis-site - Git at Google

 <!DOCTYPE HTML>
 <html lang="en">
 <head>
 <!-- Generated by javadoc (19) -->
 <title>Initializer (Apache SIS 1.3 API)</title>
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <meta name="description" content="declaration: package: org.apache.sis.util.logging, class: Initializer">
 <meta name="generator" content="javadoc/ClassWriterImpl">
 <meta name="keywords" content="org.apache.sis.util.logging.Initializer class">
 <link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style">
 <link rel="stylesheet" type="text/css" href="../../../../../sis.css" title="Style">
 <link rel="stylesheet" type="text/css" href="../../../../../script-dir/jquery-ui.min.css" title="Style">
 <link rel="stylesheet" type="text/css" href="../../../../../jquery-ui.overrides.css" title="Style">
 <script type="text/javascript" src="../../../../../script.js"></script>
 <script type="text/javascript" src="../../../../../script-dir/jquery-3.6.0.min.js"></script>
 <script type="text/javascript" src="../../../../../script-dir/jquery-ui.min.js"></script>
 </head>
 <body class="class-declaration-page">
 <script type="text/javascript">var pathtoroot = "../../../../../";
 loadScripts(document, 'script');</script>
 <noscript>
 <div>JavaScript is disabled on your browser.</div>
 </noscript>
 <div class="flex-box">
 <header role="banner" class="flex-header">
 <nav role="navigation">
 <!-- ========= START OF TOP NAVBAR ======= -->
 <div class="top-nav" id="navbar-top"><button id="navbar-toggle-button" aria-controls="navbar-top" aria-expanded="false" aria-label="Toggle navigation links"><span class="nav-bar-toggle-icon">&nbsp;</span><span class="nav-bar-toggle-icon">&nbsp;</span><span class="nav-bar-toggle-icon">&nbsp;</span></button>
 <div class="skip-nav"><a href="#skip-navbar-top" title="Skip navigation links">Skip navigation links</a></div>
 <ul id="navbar-top-firstrow" class="nav-list" title="Navigation">
 <li><a href="../../../../../index.html">Overview</a></li>
 <li><a href="package-summary.html">Package</a></li>
 <li class="nav-bar-cell1-rev">Class</li>
 <li><a href="class-use/Initializer.html">Use</a></li>
 <li><a href="package-tree.html">Tree</a></li>
 <li><a href="../../../../../deprecated-list.html">Deprecated</a></li>
 <li><a href="../../../../../index-all.html">Index</a></li>
 <li><a href="../../../../../help-doc.html#class">Help</a></li>
 </ul>
 <ul class="sub-nav-list-small">
 <li>
 <p>Summary:</p>
 <ul>
 <li>Nested</li>
 <li>Field</li>
 <li><a href="#constructor-summary">Constr</a></li>
 <li><a href="#method-summary">Method</a></li>
 </ul>
 </li>
 <li>
 <p>Detail:</p>
 <ul>
 <li>Field</li>
 <li><a href="#constructor-detail">Constr</a></li>
 <li>Method</li>
 </ul>
 </li>
 </ul>
 </div>
 <div class="sub-nav">
 <div id="navbar-sub-list">
 <ul class="sub-nav-list">
 <li>Summary:&nbsp;</li>
 <li>Nested&nbsp;|&nbsp;</li>
 <li>Field&nbsp;|&nbsp;</li>
 <li><a href="#constructor-summary">Constr</a>&nbsp;|&nbsp;</li>
 <li><a href="#method-summary">Method</a></li>
 </ul>
 <ul class="sub-nav-list">
 <li>Detail:&nbsp;</li>
 <li>Field&nbsp;|&nbsp;</li>
 <li><a href="#constructor-detail">Constr</a>&nbsp;|&nbsp;</li>
 <li>Method</li>
 </ul>
 </div>
 <div class="nav-list-search"><a href="../../../../../search.html">SEARCH</a>
 <input type="text" id="search-input" disabled placeholder="Search">
 <input type="reset" id="reset-button" disabled value="reset">
 </div>
 </div>
 <!-- ========= END OF TOP NAVBAR ========= -->
 <span class="skip-nav" id="skip-navbar-top"></span></nav>
 </header>
 <div class="flex-content">
 <main role="main">
 <!-- ======== START OF CLASS DATA ======== -->
 <div class="header">
 <div class="sub-title"><span class="package-label-in-type">Package</span>&nbsp;<a href="package-summary.html">org.apache.sis.util.logging</a></div>
 <h1 title="Class Initializer" class="title">Class Initializer</h1>
 </div>
 <div class="inheritance" title="Inheritance Tree"><a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html" title="class or interface in java.lang" class="external-link">Object</a>
 <div class="inheritance">Initializer</div>
 </div>
 <section class="class-description" id="class-description">
 <hr>
 <div class="type-signature"><span class="modifiers">public class </span><span class="element-name type-name-label">Initializer</span>
 <span class="extends-implements">extends <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html" title="class or interface in java.lang" class="external-link">Object</a></span></div>
 <div class="block">Loads a logging configuration file using Java logging syntax augmented with Apache SIS extensions.
  The <code>"java.util.logging.config.file"</code> <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/System.html#getProperty(java.lang.String)" title="class or interface in java.lang" class="external-link">system property</a>
  must be set to the path of a <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/util/Properties.html" title="class or interface in java.util" class="external-link">properties</a> file containing configuration
  in the format described by <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.logging/java/util/logging/LogManager.html" title="class or interface in java.util.logging" class="external-link"><code>LogManager</code></a>.
  This class applies the following filtering on the configuration file:

  <ul>
    <li>Changes in <code>"java.util.logging.FileHandler.pattern"</code> property value:
      <ul>
        <li>Replace <code>%p</code> by the parent directory of the logging configuration file.</li>
      </ul>
    </li>
  </ul>

  <h2>Example</h2>
  Given an application with the following directory structure:

  <pre>application
  ├─ conf/
  │  └─ logging.properties
  └─ log/</pre>

  If the <code>logging.properties</code> contains the following line:

  <pre>java.util.logging.FileHandler.pattern = <b>%p</b>/log/myapp.log</pre>

  Then the <code>%p</code> characters of that property value will be replaced by the path to the
  <code>application</code> directory, thus allowing the application to log in the <code>log/</code> sub-directory.
  Other special components such as <code>%t</code>, <code>%h</code>, <code>%g</code> or <code>%u</code> are handled as usual
  (i.e. as documented by <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.logging/java/util/logging/FileHandler.html" title="class or interface in java.util.logging" class="external-link"><code>FileHandler</code></a>).

  <h2>Usage</h2>
  This class should not referenced directly by other Java code.
  Instead, it should be specified at JVM startup time like below:

  <pre>java -Djava.util.logging.config.class=org.apache.sis.util.logging.Initializer \
      -Djava.util.logging.config.file=<i>path/to/my/application/conf/logging.properties</i></pre>

  See for example the <code>bin/sis</code> shell script in Apache SIS binary distribution.</div>
 <dl class="notes">
 <dt>Since:</dt>
 <dd>1.3</dd>
 <dt>See Also:</dt>
 <dd>
 <ul class="see-list">
 <li><a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.logging/java/util/logging/FileHandler.html" title="class or interface in java.util.logging" class="external-link"><code>FileHandler</code></a></li>
 </ul>
 </dd>

 <p><font size="-1">Defined in the <code>sis-utility</code> module</font></p>
 </dl>
 </section>
 <section class="summary">
 <ul class="summary-list">
 <!-- ======== CONSTRUCTOR SUMMARY ======== -->
 <li>
 <section class="constructor-summary" id="constructor-summary">
 <h2>Constructor Summary</h2>
 <div class="caption"><span>Constructors</span></div>
 <div class="summary-table two-column-summary">
 <div class="table-header col-first">Constructor</div>
 <div class="table-header col-last">Description</div>
 <div class="col-constructor-name even-row-color"><code><a href="#%3Cinit%3E()" class="member-name-link">Initializer</a>()</code></div>
 <div class="col-last even-row-color">
 <div class="block">Configures Java logging using a filtered configuration file.</div>
 </div>
 </div>
 </section>
 </li>
 <!-- ========== METHOD SUMMARY =========== -->
 <li>
 <section class="method-summary" id="method-summary">
 <h2>Method Summary</h2>
 <div class="inherited-list">
 <h3 id="methods-inherited-from-class-Object">Methods inherited from class&nbsp;<a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html" title="class or interface in java.lang" class="external-link">Object</a></h3>
 <code><a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html#clone()" title="class or interface in java.lang" class="external-link">clone</a>, <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html#equals(java.lang.Object)" title="class or interface in java.lang" class="external-link">equals</a>, <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html#finalize()" title="class or interface in java.lang" class="external-link">finalize</a>, <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html#getClass()" title="class or interface in java.lang" class="external-link">getClass</a>, <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html#hashCode()" title="class or interface in java.lang" class="external-link">hashCode</a>, <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html#notify()" title="class or interface in java.lang" class="external-link">notify</a>, <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html#notifyAll()" title="class or interface in java.lang" class="external-link">notifyAll</a>, <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html#toString()" title="class or interface in java.lang" class="external-link">toString</a>, <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html#wait()" title="class or interface in java.lang" class="external-link">wait</a>, <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html#wait(long)" title="class or interface in java.lang" class="external-link">wait</a>, <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html#wait(long,int)" title="class or interface in java.lang" class="external-link">wait</a></code></div>
 </section>
 </li>
 </ul>
 </section>
 <section class="details">
 <ul class="details-list">
 <!-- ========= CONSTRUCTOR DETAIL ======== -->
 <li>
 <section class="constructor-details" id="constructor-detail">
 <h2>Constructor Details</h2>
 <ul class="member-list">
 <li>
 <section class="detail" id="&lt;init&gt;()">
 <h3>Initializer</h3>
 <div class="member-signature"><span class="modifiers">public</span>&nbsp;<span class="element-name">Initializer</span>()
             throws <span class="exceptions"><a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/io/IOException.html" title="class or interface in java.io" class="external-link">IOException</a></span></div>
 <div class="block">Configures Java logging using a filtered configuration file.
  This constructor gets the configuration file referenced by
  the <code>"java.util.logging.config.file"</code> system property,
  applies the filtering described in class javadoc,
  then gives the filtered configuration to <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.logging/java/util/logging/LogManager.html#readConfiguration(java.io.InputStream)" title="class or interface in java.util.logging" class="external-link"><code>LogManager.readConfiguration(InputStream)</code></a>.

  <p>This constructor should not be invoked directly.
  See class javadoc for usage example.</p></div>
 <dl class="notes">
 <dt>Throws:</dt>
 <dd><code><a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/io/IOException.html" title="class or interface in java.io" class="external-link">IOException</a></code> - if an error occurred while reading the configuration file.</dd>
 </dl>
 </section>
 </li>
 </ul>
 </section>
 </li>
 </ul>
 </section>
 <!-- ========= END OF CLASS DATA ========= -->
 </main>
 <footer role="contentinfo">
 <hr>
 <p class="legal-copy"><small>Copyright &#169; 2010&#x2013;2022 <a href="https://www.apache.org/">The Apache Software Foundation</a>. All rights reserved.</small></p>
 </footer>
 </div>
 </div>
 </body>
 </html>
	<!DOCTYPE HTML>
	<html lang="en">
	<head>
	<!-- Generated by javadoc (19) -->
	<title>Initializer (Apache SIS 1.3 API)</title>
	<meta name="viewport" content="width=device-width, initial-scale=1">
	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
	<meta name="description" content="declaration: package: org.apache.sis.util.logging, class: Initializer">
	<meta name="generator" content="javadoc/ClassWriterImpl">
	<meta name="keywords" content="org.apache.sis.util.logging.Initializer class">
	<link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style">
	<link rel="stylesheet" type="text/css" href="../../../../../sis.css" title="Style">
	<link rel="stylesheet" type="text/css" href="../../../../../script-dir/jquery-ui.min.css" title="Style">
	<link rel="stylesheet" type="text/css" href="../../../../../jquery-ui.overrides.css" title="Style">
	<script type="text/javascript" src="../../../../../script.js"></script>
	<script type="text/javascript" src="../../../../../script-dir/jquery-3.6.0.min.js"></script>
	<script type="text/javascript" src="../../../../../script-dir/jquery-ui.min.js"></script>
	</head>
	<body class="class-declaration-page">
	<script type="text/javascript">var pathtoroot = "../../../../../";
	loadScripts(document, 'script');</script>
	<noscript>
	<div>JavaScript is disabled on your browser.</div>
	</noscript>
	<div class="flex-box">
	<header role="banner" class="flex-header">
	<nav role="navigation">
	<!-- ========= START OF TOP NAVBAR ======= -->
	<div class="top-nav" id="navbar-top"><button id="navbar-toggle-button" aria-controls="navbar-top" aria-expanded="false" aria-label="Toggle navigation links"><span class="nav-bar-toggle-icon"> </span><span class="nav-bar-toggle-icon"> </span><span class="nav-bar-toggle-icon"> </span></button>
	<div class="skip-nav"><a href="#skip-navbar-top" title="Skip navigation links">Skip navigation links</a></div>
	<ul id="navbar-top-firstrow" class="nav-list" title="Navigation">
	<li><a href="../../../../../index.html">Overview</a></li>
	<li><a href="package-summary.html">Package</a></li>
	<li class="nav-bar-cell1-rev">Class</li>
	<li><a href="class-use/Initializer.html">Use</a></li>
	<li><a href="package-tree.html">Tree</a></li>
	<li><a href="../../../../../deprecated-list.html">Deprecated</a></li>
	<li><a href="../../../../../index-all.html">Index</a></li>
	<li><a href="../../../../../help-doc.html#class">Help</a></li>
	</ul>
	<ul class="sub-nav-list-small">
	<li>
	<p>Summary:</p>
	<ul>
	<li>Nested</li>
	<li>Field</li>
	<li><a href="#constructor-summary">Constr</a></li>
	<li><a href="#method-summary">Method</a></li>
	</ul>
	</li>
	<li>
	<p>Detail:</p>
	<ul>
	<li>Field</li>
	<li><a href="#constructor-detail">Constr</a></li>
	<li>Method</li>
	</ul>
	</li>
	</ul>
	</div>
	<div class="sub-nav">
	<div id="navbar-sub-list">
	<ul class="sub-nav-list">
	<li>Summary: </li>
	<li>Nested \| </li>
	<li>Field \| </li>
	<li><a href="#constructor-summary">Constr</a> \| </li>
	<li><a href="#method-summary">Method</a></li>
	</ul>
	<ul class="sub-nav-list">
	<li>Detail: </li>
	<li>Field \| </li>
	<li><a href="#constructor-detail">Constr</a> \| </li>
	<li>Method</li>
	</ul>
	</div>
	<div class="nav-list-search"><a href="../../../../../search.html">SEARCH</a>
	<input type="text" id="search-input" disabled placeholder="Search">
	<input type="reset" id="reset-button" disabled value="reset">
	</div>
	</div>
	<!-- ========= END OF TOP NAVBAR ========= -->
	<span class="skip-nav" id="skip-navbar-top"></span></nav>
	</header>
	<div class="flex-content">
	<main role="main">
	<!-- ======== START OF CLASS DATA ======== -->
	<div class="header">
	<div class="sub-title"><span class="package-label-in-type">Package</span> <a href="package-summary.html">org.apache.sis.util.logging</a></div>
	<h1 title="Class Initializer" class="title">Class Initializer</h1>
	</div>
	<div class="inheritance" title="Inheritance Tree"><a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html" title="class or interface in java.lang" class="external-link">Object</a>
	<div class="inheritance">Initializer</div>
	</div>
	<section class="class-description" id="class-description">
	<hr>
	<div class="type-signature"><span class="modifiers">public class </span><span class="element-name type-name-label">Initializer</span>
	<span class="extends-implements">extends <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html" title="class or interface in java.lang" class="external-link">Object</a></span></div>
	<div class="block">Loads a logging configuration file using Java logging syntax augmented with Apache SIS extensions.
	The <code>"java.util.logging.config.file"</code> <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/System.html#getProperty(java.lang.String)" title="class or interface in java.lang" class="external-link">system property</a>
	must be set to the path of a <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/util/Properties.html" title="class or interface in java.util" class="external-link">properties</a> file containing configuration
	in the format described by <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.logging/java/util/logging/LogManager.html" title="class or interface in java.util.logging" class="external-link"><code>LogManager</code></a>.
	This class applies the following filtering on the configuration file:

	<ul>
	<li>Changes in <code>"java.util.logging.FileHandler.pattern"</code> property value:
	<ul>
	<li>Replace <code>%p</code> by the parent directory of the logging configuration file.</li>
	</ul>
	</li>
	</ul>

	<h2>Example</h2>
	Given an application with the following directory structure:

	<pre>application
	├─ conf/
	│ └─ logging.properties
	└─ log/</pre>

	If the <code>logging.properties</code> contains the following line:

	<pre>java.util.logging.FileHandler.pattern = <b>%p</b>/log/myapp.log</pre>

	Then the <code>%p</code> characters of that property value will be replaced by the path to the
	<code>application</code> directory, thus allowing the application to log in the <code>log/</code> sub-directory.
	Other special components such as <code>%t</code>, <code>%h</code>, <code>%g</code> or <code>%u</code> are handled as usual
	(i.e. as documented by <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.logging/java/util/logging/FileHandler.html" title="class or interface in java.util.logging" class="external-link"><code>FileHandler</code></a>).

	<h2>Usage</h2>
	This class should not referenced directly by other Java code.
	Instead, it should be specified at JVM startup time like below:

	<pre>java -Djava.util.logging.config.class=org.apache.sis.util.logging.Initializer \
	-Djava.util.logging.config.file=<i>path/to/my/application/conf/logging.properties</i></pre>

	See for example the <code>bin/sis</code> shell script in Apache SIS binary distribution.</div>
	<dl class="notes">
	<dt>Since:</dt>
	<dd>1.3</dd>
	<dt>See Also:</dt>
	<dd>
	<ul class="see-list">
	<li><a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.logging/java/util/logging/FileHandler.html" title="class or interface in java.util.logging" class="external-link"><code>FileHandler</code></a></li>
	</ul>
	</dd>

	<p><font size="-1">Defined in the <code>sis-utility</code> module</font></p>
	</dl>
	</section>
	<section class="summary">
	<ul class="summary-list">
	<!-- ======== CONSTRUCTOR SUMMARY ======== -->
	<li>
	<section class="constructor-summary" id="constructor-summary">
	<h2>Constructor Summary</h2>
	<div class="caption"><span>Constructors</span></div>
	<div class="summary-table two-column-summary">
	<div class="table-header col-first">Constructor</div>
	<div class="table-header col-last">Description</div>
	<div class="col-constructor-name even-row-color"><code><a href="#%3Cinit%3E()" class="member-name-link">Initializer</a>()</code></div>
	<div class="col-last even-row-color">
	<div class="block">Configures Java logging using a filtered configuration file.</div>
	</div>
	</div>
	</section>
	</li>
	<!-- ========== METHOD SUMMARY =========== -->
	<li>
	<section class="method-summary" id="method-summary">
	<h2>Method Summary</h2>
	<div class="inherited-list">
	<h3 id="methods-inherited-from-class-Object">Methods inherited from class <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html" title="class or interface in java.lang" class="external-link">Object</a></h3>
	<code><a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html#clone()" title="class or interface in java.lang" class="external-link">clone</a>, <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html#equals(java.lang.Object)" title="class or interface in java.lang" class="external-link">equals</a>, <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html#finalize()" title="class or interface in java.lang" class="external-link">finalize</a>, <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html#getClass()" title="class or interface in java.lang" class="external-link">getClass</a>, <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html#hashCode()" title="class or interface in java.lang" class="external-link">hashCode</a>, <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html#notify()" title="class or interface in java.lang" class="external-link">notify</a>, <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html#notifyAll()" title="class or interface in java.lang" class="external-link">notifyAll</a>, <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html#toString()" title="class or interface in java.lang" class="external-link">toString</a>, <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html#wait()" title="class or interface in java.lang" class="external-link">wait</a>, <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html#wait(long)" title="class or interface in java.lang" class="external-link">wait</a>, <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/lang/Object.html#wait(long,int)" title="class or interface in java.lang" class="external-link">wait</a></code></div>
	</section>
	</li>
	</ul>
	</section>
	<section class="details">
	<ul class="details-list">
	<!-- ========= CONSTRUCTOR DETAIL ======== -->
	<li>
	<section class="constructor-details" id="constructor-detail">
	<h2>Constructor Details</h2>
	<ul class="member-list">
	<li>
	<section class="detail" id="<init>()">
	<h3>Initializer</h3>
	<div class="member-signature"><span class="modifiers">public</span> <span class="element-name">Initializer</span>()
	throws <span class="exceptions"><a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/io/IOException.html" title="class or interface in java.io" class="external-link">IOException</a></span></div>
	<div class="block">Configures Java logging using a filtered configuration file.
	This constructor gets the configuration file referenced by
	the <code>"java.util.logging.config.file"</code> system property,
	applies the filtering described in class javadoc,
	then gives the filtered configuration to <a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.logging/java/util/logging/LogManager.html#readConfiguration(java.io.InputStream)" title="class or interface in java.util.logging" class="external-link"><code>LogManager.readConfiguration(InputStream)</code></a>.

	<p>This constructor should not be invoked directly.
	See class javadoc for usage example.</p></div>
	<dl class="notes">
	<dt>Throws:</dt>
	<dd><code><a href="https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/io/IOException.html" title="class or interface in java.io" class="external-link">IOException</a></code> - if an error occurred while reading the configuration file.</dd>
	</dl>
	</section>
	</li>
	</ul>
	</section>
	</li>
	</ul>
	</section>
	<!-- ========= END OF CLASS DATA ========= -->
	</main>
	<footer role="contentinfo">
	<hr>
	<p class="legal-copy"><small>Copyright © 2010–2022 <a href="https://www.apache.org/">The Apache Software Foundation</a>. All rights reserved.</small></p>
	</footer>
	</div>
	</div>
	</body>
	</html>