API for java-utils
- ()
by Stuart Halloway, Stephen C. Gilardi, Shawn Hoover, Perry Trolard, Stuart Sierra
clojure-contrib is now deprecated
clojure-contrib is no longer being developed or maintained.
Rather than a single, monolithic, contributions library, Clojure now has
a set of separate libraries for each unit of functionality. The libraries
are in the Clojure GitHub organization at
https://github.com/clojure.
API documentation of the libraries can be found at
https://clojure.github.io.
If you're looking for a specific function or namespace from the old
clojure-contrib, see
"Where Did Clojure.Contrib Go".
Full namespace name:
clojure.contrib.java-utils
Overview
A set of utilties for dealing with Java stuff like files and properties.
Design goals:
(1) Ease-of-use. These APIs should be convenient. Performance is secondary.
(2) Duck typing. I hate having to think about the difference between
a string that names a file, and a File. Ditto for a ton of other
wrapper classes in the Java world (URL, InternetAddress). With these
APIs you should be able to think about domain equivalence, not type
equivalence.
(3) No bossiness. I am not marking any of these functions as private
the docstrings will tell you the intended usage but do what works for you.
Feedback welcome!
If something in this module violates the principle of least surprise, please
let me (Stu) and the Clojure community know via the mailing list.
Contributors:
Stuart Halloway
Stephen C. Gilardi
Shawn Hoover
Perry Trolard
Stuart Sierra
Public Variables and Functions
as-properties
function
This library, clojure-contrib, is deprecated. See here for more information.
Usage: (as-properties m)
Convert any seq of pairs to a java.utils.Properties instance.
Uses name to convert both keys and values into strings.
Source
get-system-property
function
This library, clojure-contrib, is deprecated. See here for more information.
Usage: (get-system-property stringable)
(get-system-property stringable default)
Get a system property.
Source
read-properties
function
This library, clojure-contrib, is deprecated. See here for more information.
Usage: (read-properties file-able)
Read properties from file-able.
Source
set-system-properties
function
This library, clojure-contrib, is deprecated. See here for more information.
Usage: (set-system-properties settings)
Set some system properties. Nil clears a property.
Source
with-system-properties
macro
This library, clojure-contrib, is deprecated. See here for more information.
Usage: (with-system-properties settings & body)
setting => property-name value
Sets the system properties to the supplied values, executes the body, and
sets the properties back to their original values. Values of nil are
translated to a clearing of the property.
Source
write-properties
function
This library, clojure-contrib, is deprecated. See here for more information.
Usage: (write-properties m file-able)
(write-properties m file-able comments)
Write properties to file-able.
Source