org.liquidplayer.service

Interface Surface

public interface Surface

A Surface is a UI interaction layer with a MicroService.

Method Summary

Modifier and Type	Method and Description
android.view.View	attach(MicroService service, java.lang.Runnable onAttached) Attaches a MicroService to the UI.
void	bind(MicroService service, JSContext context, Synchronizer synchronizer) Binds a MicroService to the surface.
void	detach() Detaches any currently attached MicroService.
void	reset() Detaches and clears the Surface.

Method Detail

bind

void bind(MicroService service,
          JSContext context,
          Synchronizer synchronizer)

Binds a MicroService to the surface. This will get called after the micro service is started, but before the service javascript is executed. This gives the surface an opportunity to bind any native functions required by the module.

Parameters:

service - The microservice to bind

context - The Javascript context on which to bind

synchronizer - Used for synchronizing asynchronous init

attach

android.view.View attach(MicroService service,
                         java.lang.Runnable onAttached)

Attaches a MicroService to the UI.

Parameters:

service - The MicroService to attach

onAttached - A runnable to be called after the UI is active

detach

void detach()

Detaches any currently attached MicroService. The Surface may then be ready to be discarded or reattached to another MicroService.

reset

void reset()

Detaches and clears the Surface. This is the preferred method when the Surface is to be reused. detach() may leave behind some UI state, as it expects that the MicroService may later be re-attached. reset() clears any UI state back to a fresh state.