xapi.io.impl

Class IOServiceDefault

java.lang.Object

xapi.io.impl.IOServiceDefault

All Implemented Interfaces:

IOService

@SingletonDefault(implFor=IOService.class)
public class IOServiceDefault
extends Object
implements IOService

Constructor Summary

Constructors

Constructor and Description
IOServiceDefault()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	applySettings(URLConnection connect, int modifiers) Allow subclasses to apply any settings to the connection before we open it
void	delete(String url, StringDictionary<String> headers, IOCallback<IOMessage<String>> callback)
void	get(String uri, StringDictionary<String> headers, IOCallback<IOMessage<String>> callback)
protected String	normalize(String uri)
void	post(String url, String body, StringDictionary<String> headers, IOCallback<IOMessage<String>> callback)
void	put(String url, byte[] body, StringDictionary<String> headers, IOCallback<IOMessage<String>> callback)
<V> xapi.util.api.RemovalHandler	registerParser(Class<V> classLit, xapi.util.api.ConvertsValue<V,String> serializer, xapi.util.api.ConvertsValue<String,V> deserializer) Registers a de/serializer for a given class literal, and returns a removal method to undo the registration.
<V> IORequestBuilder<V>	request(Class<V> classLit, String id)
protected String	toUrl(Class<?> classLit, String id)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

IOServiceDefault

public IOServiceDefault()

Method Detail

request

public <V> IORequestBuilder<V> request(Class<V> classLit,
                              String id)

Specified by:

request in interface IOService

registerParser

public <V> xapi.util.api.RemovalHandler registerParser(Class<V> classLit,
                                              xapi.util.api.ConvertsValue<V,String> serializer,
                                              xapi.util.api.ConvertsValue<String,V> deserializer)

Description copied from interface: IOService

Registers a de/serializer for a given class literal, and returns a removal method to undo the registration. The ONLY safe way to use the undo method is to a) synchronize(classLit) { b) RemovalHandler r = registerParser(...); try { // do stuff, but don't try to acquire a lock. // just send your request and get out. } finally { r.remove();// resets the given de/serializer combo. } Do not keep references of the removal handler beyond the method that called registerParser, unless you are willing to risk indeterminism. We will do check-and-set, Also, for code to work in gwt or other transpiled targets, you MUST be using a class literal, and not a class _REFERENCE_. registerParser(IPojo.class, ...) - Good! Class theClass = IPojo.class; registerParser(theClass, ...) - Bad! When you use class literals, the reference can be reliably resolved, otherwise it's on you to record every method passing that class lit along, and do something filthy, like stash it in a ThreadLocal<Stack>,. The deal for magically generated code is "pass in the interface you want, get back the best (or only) implementation for your platform.

Specified by:

registerParser in interface IOService

Parameters:

classLit - - The type to register serializers for.

serializer - - ConvertsValue

deserializer - - ConvertsValue

Returns:

- A removal method to undo registration; using this in a try / finally block, in case you just want to borrow the de/serialization process.

put

public void put(String url,
       byte[] body,
       StringDictionary<String> headers,
       IOCallback<IOMessage<String>> callback)

Specified by:

put in interface IOService

get

public void get(String uri,
       StringDictionary<String> headers,
       IOCallback<IOMessage<String>> callback)

Specified by:

get in interface IOService

applySettings

protected void applySettings(URLConnection connect,
                 int modifiers)

Allow subclasses to apply any settings to the connection before we open it

Parameters:

connect - - The url connection, just before it is opened.

modifiers - - The type of connection, see IOConstants.METHOD_GET, IOConstants.METHOD_PUT and friends

normalize

protected String normalize(String uri)

toUrl

protected String toUrl(Class<?> classLit,
           String id)

post

public void post(String url,
        String body,
        StringDictionary<String> headers,
        IOCallback<IOMessage<String>> callback)

Specified by:

post in interface IOService

delete

public void delete(String url,
          StringDictionary<String> headers,
          IOCallback<IOMessage<String>> callback)

Specified by:

delete in interface IOService