public class

URIEditor

extends PropertyEditorSupport
java.lang.Object
   ↳ java.beans.PropertyEditorSupport
     ↳ org.springframework.beans.propertyeditors.URIEditor

Class Overview

Editor for java.net.URI, to directly populate a URI property instead of using a String property as bridge.

Supports Spring-style URI notation: any fully qualified standard URI ("file:", "http:", etc) and Spring's special "classpath:" pseudo-URL, which will be resolved to a corresponding URI.

By default, this editor will encode Strings into URIs. For instance, a space will be encoded into %20. This behavior can be changed by setting calling the URIEditor(boolean) constructor.

Note: A URI is more relaxed than a URL in that it does not require a valid protocol to be specified. Any scheme within a valid URI syntax is allowed, even without a matching protocol handler being registered.

See Also

Summary

Public Constructors
URIEditor()
Create a new, encoding URIEditor, converting "classpath:" locations into standard URIs (not trying to resolve them into physical resources).
URIEditor(boolean encode)
Create a new URIEditor, converting "classpath:" locations into standard URIs (not trying to resolve them into physical resources).
URIEditor(ClassLoader classLoader)
Create a new URIEditor, using the given ClassLoader to resolve "classpath:" locations into physical resource URLs.
URIEditor(ClassLoader classLoader, boolean encode)
Create a new URIEditor, using the given ClassLoader to resolve "classpath:" locations into physical resource URLs.
Public Methods
String getAsText()
void setAsText(String text)
Protected Methods
URI createURI(String value)
Create a URI instance for the given (resolved) String value.
[Expand]
Inherited Methods
From class java.beans.PropertyEditorSupport
From class java.lang.Object
From interface java.beans.PropertyEditor

Public Constructors

public URIEditor ()

Also: SpringBeans

Create a new, encoding URIEditor, converting "classpath:" locations into standard URIs (not trying to resolve them into physical resources).

public URIEditor (boolean encode)

Also: SpringBeans

Create a new URIEditor, converting "classpath:" locations into standard URIs (not trying to resolve them into physical resources).

Parameters
encode indicates whether Strings will be encoded or not

public URIEditor (ClassLoader classLoader)

Also: SpringBeans

Create a new URIEditor, using the given ClassLoader to resolve "classpath:" locations into physical resource URLs.

Parameters
classLoader the ClassLoader to use for resolving "classpath:" locations (may be null to indicate the default ClassLoader)

public URIEditor (ClassLoader classLoader, boolean encode)

Also: SpringBeans

Create a new URIEditor, using the given ClassLoader to resolve "classpath:" locations into physical resource URLs.

Parameters
classLoader the ClassLoader to use for resolving "classpath:" locations (may be null to indicate the default ClassLoader)
encode indicates whether Strings will be encoded or not

Public Methods

public String getAsText ()

public void setAsText (String text)

Throws
IllegalArgumentException

Protected Methods

protected URI createURI (String value)

Also: SpringBeans

Create a URI instance for the given (resolved) String value.

The default implementation encodes the value into a RFC 2396 compliant URI.

Parameters
value the value to convert into a URI instance
Returns
  • the URI instance
Throws
URISyntaxException if URI conversion failed