PageBoxLib
Class Querier

java.lang.Object
  PageBoxLib.Querier

All Implemented Interfaces:

QuerierIF

public class Querier

extends java.lang.Object

implements QuerierIF

Web service invoker.

Changes:

• 0.0.11: log parameter on setUrl method; no log parameter on constructor
• 0.1.0: getMessage -> toString to get more info in case of exception;
• 0.1.1: current url member for tracing purpose

alexis.grandemange@pagebox.net

Copyright (c) 2002-2004 Alexis Grandemange

This program is free software; you can redistribute it and/or
 modify it under the terms of the GNU Lesser General Public License
 as published by the Free Software Foundation; version 2.1 of the
 License.
 This library is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 GNU Lesser General Public License for more details.
 A copy of the GNU Lesser General Public License lesser.txt should be
 included in the distribution.

Version:

0, 1, 1

Author:

Alexis Grandemange

Field Summary

private Log	log Logging object
(package private) QuerierIF	qi Class calling the DeployIF Web service
(package private) java.lang.String	url For tracing purpose current URL

Constructor Summary

private

Querier(QuerierIF qi) Constructor.

Method Summary

DeployIF.Status	frameSend(TokenFrame frame) TokenIF method.
(package private) static Querier	getQuerier(java.lang.String querierClass) Factory method.
RepoQueryIF.AuthSub[]	GetSubscribers(java.lang.String archive) Query API.
void	Notify(java.lang.String archive, RepoQueryIF.UrlStatus[] subscribers) Called by relay to notify the success or failure of a deployment.
void	NotifyFix(java.lang.String subscriber, FixArch[] archives) Called by Reinstall to change the archive status from PageBox err to installed.
void	setUrl(java.lang.String url, java.lang.String user, java.lang.String passwd, Log log) Set the Web service URI.
void	tokenRegister(java.lang.String subscriber) Token management method.
void	tokenUnregister(java.lang.String subscriber) Token management method.

Methods inherited from class java.lang.Object

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

Field Detail

log

private Log log

Logging object

qi

QuerierIF qi

Class calling the DeployIF Web service

url

java.lang.String url

For tracing purpose current URL

Constructor Detail

Querier

private Querier(QuerierIF qi)

Constructor. Private: can be called only by getDeployer.

Method Detail

getQuerier

static Querier getQuerier(java.lang.String querierClass)

Factory method. Creates a Deployer for deployerclass.

Parameters:

querierClass - name of the class calling the RepoQueryIF Web service

setUrl

public void setUrl(java.lang.String url,
                   java.lang.String user,
                   java.lang.String passwd,
                   Log log)

Set the Web service URI.

Specified by:

setUrl in interface QuerierIF

Parameters:

url - Web service URI.

user - Web service account ID

passwd - Web service account password

log - logging object

GetSubscribers

public RepoQueryIF.AuthSub[] GetSubscribers(java.lang.String archive)

Query API.

Parameters:

archive - archive name

Returns:

array of AuthSub objects

Notify

public void Notify(java.lang.String archive,
                   RepoQueryIF.UrlStatus[] subscribers)
            throws java.rmi.RemoteException

Called by relay to notify the success or failure of a deployment.

Parameters:

archive - archive name

Throws:

java.rmi.RemoteException

NotifyFix

public void NotifyFix(java.lang.String subscriber,
                      FixArch[] archives)
               throws java.rmi.RemoteException

Called by Reinstall to change the archive status from PageBox err to installed.

Parameters:

subscriber - PageBox whose setting pb was fixed

archives - whose pb was fixed

Throws:

java.rmi.RemoteException

frameSend

public DeployIF.Status frameSend(TokenFrame frame)
                          throws java.rmi.RemoteException

TokenIF method. Send the frame to the next station on the adjacency list.

Parameters:

frame - sent frame

Returns:

status object

Throws:

java.rmi.RemoteException

tokenRegister

public void tokenRegister(java.lang.String subscriber)
                   throws java.rmi.RemoteException

Token management method. Inserts a PageBox on the ring.

Parameters:

subscriber - PageBox whose setting pb was fixed

Throws:

java.rmi.RemoteException

tokenUnregister

public void tokenUnregister(java.lang.String subscriber)
                     throws java.rmi.RemoteException

Token management method. Removes a PageBox from the ring.

Parameters:

subscriber - PageBox whose setting pb was fixed

Throws:

java.rmi.RemoteException