com.sun.star.lib.uno.environments.remote

Interface IThreadPool

All Known Implementing Classes:

JavaThreadPool

public interface IThreadPool

This interface is an abstraction of the various threadpool implementations.

Since:

UDK1.0

See Also:

ThreadPoolManager

Method Summary

Modifier and Type	Method and Description
void	attach() Attaches this thread to the thread pool.
Object	attach(ThreadId id) As above, but hands in an already existing instance of the threadid of the current thread.
void	destroy() Destroys the thread pool and tries to join all created threads immediately.
void	detach() Detaches this thread from the thread pool.
void	detach(Object handle, ThreadId id) As above, but hands in an already existing instance of the threadid of the current thread and a handle returned by attach.
void	dispose(Throwable throwable) Disposes this thread pool, thus releasing all threads by throwing a DisposedException with the given Throwable cause.
Object	enter() Lets this thread enter the thread pool.
Object	enter(Object handle, ThreadId id) As above but hands in an already existing instance of the threadid of the current thread and a handle returned by attach.
ThreadId	getThreadId() Retrieves the global threadId for the current thread.
void	putJob(Job job) Queues a job into the jobQueue of the thread belonging to the jobs threadId.

Method Detail

getThreadId

ThreadId getThreadId()

Retrieves the global threadId for the current thread.

Returns:

the thread id.

attach

void attach()

Attaches this thread to the thread pool.

See Also:

enter()

attach

Object attach(ThreadId id)

As above, but hands in an already existing instance of the threadid of the current thread.

The function exists for performance.

Returns:

Returns a handle which can be used in enter and detach calls.

See Also:

attach()

detach

void detach()

Detaches this thread from the thread pool.

See Also:

enter()

detach

void detach(Object handle,
            ThreadId id)

As above, but hands in an already existing instance of the threadid of the current thread and a handle returned by attach.

The function exists for performance.

See Also:

attach(), detach()

enter

Object enter()
      throws Throwable

Lets this thread enter the thread pool.

This thread then executes all jobs put via putJob until a reply job arrives.

Throws:

Throwable

See Also:

putJob(com.sun.star.lib.uno.environments.remote.Job)

enter

Object enter(Object handle,
             ThreadId id)
      throws Throwable

As above but hands in an already existing instance of the threadid of the current thread and a handle returned by attach.

This thread then executes all jobs put via putJob until a reply job arrives.

Throws:

Throwable

See Also:

putJob(com.sun.star.lib.uno.environments.remote.Job)

putJob

void putJob(Job job)

Queues a job into the jobQueue of the thread belonging to the jobs threadId.

Parameters:

job - the job

dispose

void dispose(Throwable throwable)

Disposes this thread pool, thus releasing all threads by throwing a DisposedException with the given Throwable cause.

Parameters:

throwable - the cause

destroy

void destroy()

Destroys the thread pool and tries to join all created threads immediately.