You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
<ahref="https://github.com/JavaMoney/javamoney-lib" id="view-on-github" class="button"><span>View on GitHub</span></a>
82
+
</section>
83
+
84
+
<hr>
85
+
86
+
<sectionid="main_content">
87
+
<h3>
88
+
<aname="welcome-to-the-javamoney-financial-library" class="anchor" href="#welcome-to-the-javamoney-financial-library"><spanclass="octicon octicon-link"></span></a>Welcome to the JavaMoney financial library.</h3>
89
+
90
+
<p>JavaMoney-lib is a financial library that is built upon JSR 354 (or compatible libraries). Whereas the JSR 354 API and reference implementation provides the fundamentals like monetary amounts, customizable currencies and interfaces for interoperation this library adds additional powerful APIs and SPIs that were implemented during JSR development as a proof of concept:</p>
91
+
92
+
<ul>
93
+
<li>
94
+
<strong>Currency Conversion</strong>, supporting multiple conversion data providers, direct and derived (chained) rates, current, as well as historic conversion. Also feed implementations from the European Central Bank (EZB) and the International Monetary Funds (IMF) were available, that support currency conversion back to 1995 for almost every ISO currency.</li>
95
+
<li>
96
+
<strong>Currency Services</strong>, provide a EE styled service, which allows querying currencies available and supports mapping between different currency naming schemes.</li>
97
+
<li>
98
+
<strong>Formatting</strong> provides an extendable formatting library that allows to define complex formatters, that can be configured in arbitrary ways using <code>LocalizationStyle</code> instances. Also available is a flexible Builder for creating arbitrary complex formatters and parsers based on an ordered set of arbitrary tokens.</li>
99
+
<li>
100
+
<strong>Region API</strong> provides a forest (a set of trees) of regions. This allows to model regional hierarchies in a more flexible and intuitive way, than adding all functionalities into <code>java.util.Locale</code>. By default the Unicode CLDR region tree, well as ISO countries defined by the 2- or 3-letter country code are available. Of course, the API is fully extendible, so customer related regions such as legal units, customer segments etc can be mapped easily to this API, also.</li>
101
+
<li>
102
+
<strong>Validity API</strong> This API provides a generic API for accessing historic validity information for arbitrary items, and for relationships between items. By default the API provides access to the historic relationship of currencies to countries using the Unicode CLDR data.</li>
103
+
<li>
104
+
<strong>common</strong> provides general functionality, such as an automatic data loader, which allows to update and locally cache arbitrary remote resources, and inform clients, if a new version of a resource was detected.</li>
105
+
<li>
106
+
<strong>calc</strong> finally provides a set of moentary calculations and formulas. The idea here is to provide a comprehensive set of algorithms and tools to perform complex financial mathematics. </li>
107
+
<li>
108
+
<strong>bundles</strong> finally provides the library in different flavors, targeting different execution environments:
109
+
** <strong>se</strong> loading SPIs only using the JDK <code>ServiceLoader</code>.
110
+
** <strong>se-cdi</strong> loading SPIs based on a Weld SE container.
111
+
** <strong>ee</strong> loading SPIs based on CDI in a Java EE environment >= EE6.</li>
112
+
</ul><p>To use the library you simply have to add the Maven dependency to your project (tbd)</p>
<versionId>the current version</version>
118
+
</dependency>
119
+
</code></pre>
120
+
121
+
<h3>
122
+
<aname="authors-and-contributors" class="anchor" href="#authors-and-contributors"><spanclass="octicon octicon-link"></span></a>Authors and Contributors</h3>
123
+
124
+
<p>Different people have contributed to this project. During the development of JSR 354, <ahref="https://github.com/atsticks" class="user-mention">@atsticks</a> and <ahref="https://github.com/keilw" class="user-mention">@keilw</a> founded this project and were also the main contributors. Nevertheless everybody is really welcome to help us, to make this library more feasible and add features.</p>
<p>The javamoney incubator module is for testing out new features or modules before they enter the official javamoney library. This allows to gain experience and make components error prone and performant and enables a discussion of new features with a broader community.</p>
130
+
131
+
<h3>
132
+
<aname="support-or-contact" class="anchor" href="#support-or-contact"><spanclass="octicon octicon-link"></span></a>Support or Contact</h3>
133
+
134
+
<p>Having trouble with Pages? Check out the documentation at http://tbd/pages or contact <ahref="mailto:support@javamoney.org">support@javamoney.org</a>.</p>
0 commit comments