[jira] [Created] (IO-314) Deprecate and then remove all methods that use the default encoding

2012-03-26 Thread Aaron Digulla (Created) (JIRA)
Deprecate and then remove all methods that use the default encoding
---

 Key: IO-314
 URL: https://issues.apache.org/jira/browse/IO-314
 Project: Commons IO
  Issue Type: Improvement
  Components: Streams/Writers
Affects Versions: 2.1
Reporter: Aaron Digulla
Priority: Minor


On Stackoverflow.com, I often see this kind of question: When I read my text 
on a different computer, it's all garbled.

The underlying issue is that people don't understand the concept of encoding 
and therefore, they use the default encoding which breaks their code when they 
least expect it. Worse, it often causes data corruption without throwing 
exceptions.

Therefore my suggestion: Deprecate and then remove all methods that use the 
default encoding. Users should always specify an encoding when doing text I/O, 
to make sure that data cannot be corrupted even when they don't know what 
they're doing.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: 
https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira




[jira] [Created] (IO-315) Replace all String encoding parameters with a value type

2012-03-26 Thread Aaron Digulla (Created) (JIRA)
Replace all String encoding parameters with a value type
--

 Key: IO-315
 URL: https://issues.apache.org/jira/browse/IO-315
 Project: Commons IO
  Issue Type: New Feature
  Components: Streams/Writers
Affects Versions: 2.1
Reporter: Aaron Digulla


Please create an interface Encoding plus a set of useful defaults (UTF_8, 
ISO_LATIN_1, CP_1250 and CP_1252).

Use this interface in all places where String encoding is used now. This 
would make the API more reliable, improve code reuse and reduce futile catch 
blocks for {{UnsupportedEncodingException}}.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: 
https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira




[jira] [Created] (IO-316) New API: BackupFileWriter

2012-03-26 Thread Aaron Digulla (Created) (JIRA)
New API: BackupFileWriter
-

 Key: IO-316
 URL: https://issues.apache.org/jira/browse/IO-316
 Project: Commons IO
  Issue Type: Bug
  Components: Streams/Writers
Affects Versions: 2.1
Reporter: Aaron Digulla
Priority: Minor


Add the new file based I/O class {{BackupFileWriter}} with the following 
properties:

- Saves the file to a temporary name
- Creates backup of existing file on {{close()}}
- Renames temp file to desired name on {{close()}}

The backup strategy (number of backups, backup file name) should be pluggable.

There should also be a hook to compare the temporary and the existing file and 
do the rename only when they are different. The default hook should always 
replace the file.

It should also be possible to override the temporary file name (including the 
path, so the temp file can be in the same directory or a different one or even 
on a different disk).

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: 
https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira




[jira] [Created] (LANG-795) Replace all String encoding parameters with Charset

2012-03-26 Thread Aaron Digulla (Created) (JIRA)
Replace all String encoding parameters with Charset
-

 Key: LANG-795
 URL: https://issues.apache.org/jira/browse/LANG-795
 Project: Commons Lang
  Issue Type: New Feature
  Components: lang.*
Affects Versions: 3.1
Reporter: Aaron Digulla


In several places, String constants are used to specify an encoding for data.

Please add methods that accept {{Charset}} instead, and deprecate the existing 
methods.

The goal of this change is to reduce code smell (using String constants instead 
of a real value type).

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: 
https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira