|
12 | 12 | <section name="Commons Codec"> |
13 | 13 |
|
14 | 14 | <p> |
15 | | - Welcome, to Commons Codec. Common Codec is an attempt to provide |
16 | | - definitive implementations of commonly used encoders and decoders. |
| 15 | + Welcome. Commons Codec provides implementations of common |
| 16 | + encoders and decoders such as Base64, Hex, various phonetic |
| 17 | + encodings, and URLs. |
17 | 18 | </p> |
18 | 19 |
|
19 | 20 | </section> |
20 | 21 |
|
| 22 | + <section name="Impetus"> |
| 23 | + <p> |
| 24 | + Codec was formed as an attempt to focus development effort on one |
| 25 | + definitive implementation of the Base64 encoder. At the time of |
| 26 | + Codec's proposal, there were approximately 34 different Java |
| 27 | + classes that dealt with Base64 encoding spread over the |
| 28 | + Foundation's CVS repository. Developers in the Jakarta Tomcat |
| 29 | + project had implemented an original version of the Base64 codec |
| 30 | + which had been copied by the Commons HttpClient and Apache XML |
| 31 | + project's XML-RPC subproject. After almost one year, the two |
| 32 | + forked versions of Base64 had significantly diverged from one |
| 33 | + another. XML-RPC had applied numerous fixes and patches which |
| 34 | + were not applied to the Commons HttpClient Base64. Different |
| 35 | + subprojects had differing implementations at various levels |
| 36 | + of compliance with the RFC 2045. |
| 37 | + </p> |
| 38 | + <p> |
| 39 | + Out of that confusing duplication of effort sprang this simple |
| 40 | + attempt to encourage code reuse among various projects. While |
| 41 | + this package contains a abstract framework for the creation |
| 42 | + encoders and decoders, Codec itself is primarily focused on |
| 43 | + providing functional utilities for working with common encodings. |
| 44 | + </p> |
| 45 | + </section> |
| 46 | + |
21 | 47 | <section name="Releases"> |
22 | 48 | <ul> |
23 | 49 | <li>Version 1.1 (from mirror) |
|
30 | 56 |
|
31 | 57 | <p> |
32 | 58 | Codec is currently comprised of a modest set of utilities and a |
33 | | - simple framework for String encoding and decoding. |
| 59 | + simple framework for encoding and decoding both textual and binary data. |
34 | 60 | </p> |
35 | 61 |
|
36 | 62 | <subsection name="Common Encoders"> |
|
0 commit comments