Package com.portal.app.cc.comp

Class PDeviceSearchPanelBean

java.lang.Object

com.portal.bas.PControllerImpl

com.portal.bas.comp.PIAComponentCollectionBean

com.portal.app.comp.PIASearchPanelBean

com.portal.app.cc.comp.PDeviceSearchPanelBean

All Implemented Interfaces:

PIASearch, PIACollectionBean, PControllerBean, Serializable, Remote, Unreferenced

public class PDeviceSearchPanelBean
extends PIASearchPanelBean

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.portal.app.comp.PIASearchPanelBean

PIASearchPanelBean.ValueType

Field Summary

Fields inherited from class com.portal.app.comp.PIASearchPanelBean

mSearchData, mSecConn, stepSearchSize

Fields inherited from class com.portal.bas.PControllerImpl

mFList, mRemoteListeners, UPDATE_CLIENT, UPDATE_MODEL_CHANGE, UPDATE_NEW_MODEL, UPDATE_PROPERTY

Fields inherited from interface com.portal.app.comp.PIASearch

PROGRESS_END, PROGRESS_ERROR, PROGRESS_INTERRUPT, PROGRESS_START

Constructor Summary

Constructors

Constructor	Description
PDeviceSearchPanelBean()	Creates the search panel controller

Method Summary

Modifier and Type	Method	Description
void	setAccountDb(PModelHandle accountModel)	This method sets the database for single db search to the database of the input account.
void	setAllowedDeviceStatuses(int[] allowedStatuses)	This method sets the statuses that are allowed in the search result.
protected void	setupSearch(String sClass, String[] res, PModelHandle[] argV, Vector assClasses)	Generic search setup.
PModelHandle[]	startSearch(PModelHandle[] criteria, Vector assClasses)	This method initializes the connection from the connection pool and starts the search.

Methods inherited from class com.portal.app.comp.PIASearchPanelBean

closeConnection, endSearch, fieldValueType, fireResultsEvent, getBrandPoid, getDesiredResults, getHeader, getProgress, getRemoteOnly, getResultsBatch, getSearchClass, handleDistributeToListener, hasBrandHost, isBrandHost, isCanonField, isLoginRoot, mungeStr, setDesiredResults, setFilterBrandAccTypesFlag, setFilterNonBrandHostAccsFlag, setRemoteOnly, setScope, setScopeEntryPoint, setSearchClass, setSecondaryConnection, setSingleDBSearchEnabled, setSingleDBSearchID, setSingleDBSearchID, startSearch, unsetSecondaryConnection

Methods inherited from class com.portal.bas.comp.PIAComponentCollectionBean

addChild, getCollectedData, getSelectionDataFor, removeChild, update

Methods inherited from class com.portal.bas.PControllerImpl

addRemoteListener, closeSecContext, createClientException, distributeEventToListeners, fireModelChangeEvent, getAppController, getArrayRange, getContext, getField, getField, getField, getFieldWithRestriction, getFieldWithRestriction, getFieldWithRestriction, getModel, getRemoteListenerHandle, getSecContext, isLight, register, releaseContext, releaseRemoteListener, removeRemoteListener, setField, setField, setModel, unreferenced

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.portal.bas.PControllerBean

addRemoteListener, getArrayRange, getModel, getRemoteListenerHandle, getSelectionDataFor, isLight, register, releaseRemoteListener, removeRemoteListener, setModel

Constructor Details

PDeviceSearchPanelBean

public PDeviceSearchPanelBean()
                       throws RemoteException

Creates the search panel controller

Throws:

RemoteException

Method Details

startSearch

public PModelHandle[] startSearch(PModelHandle[] criteria,
 Vector assClasses)
                           throws RemoteException

This method initializes the connection from the connection pool and starts the search. The same connection must be used throughout the step search cycle. The connection should be returned to the connection pool when the search is completed. This method sets the brand context of the connection that will be used for step search to that of the primary application. If you override this method and need to access mSecConn, make sure setSecondaryConnection is called first to initialize mSecConn. Any time this method throws an exception or does not obtain results, use unsetSecondaryConnection to add the connection back to the pool.

Specified by:

startSearch in interface PIASearch

Overrides:

startSearch in class PIASearchPanelBean

Parameters:

criteria - the search arguments

assClasses - the Portal storable class names associated with the search arguments

Returns:

the first set of search results

Throws:

RemoteException - if anything goes wrong

setAllowedDeviceStatuses

public void setAllowedDeviceStatuses(int[] allowedStatuses)
                              throws RemoteException

This method sets the statuses that are allowed in the search result. The specified status values will be appended to the search arguments.

Parameters:

allowedStatuses - the statuses that are allowed in the search result

Throws:

RemoteException - if anything goes wrong

setAccountDb

public void setAccountDb(PModelHandle accountModel)
                  throws RemoteException

This method sets the database for single db search to the database of the input account.

Parameters:

accountModel - the account to which the device is to be associated

Throws:

RemoteException - if anything goes wrong

setupSearch

protected void setupSearch(String sClass,
 String[] res,
 PModelHandle[] argV,
 Vector assClasses)
                    throws RemoteException

Generic search setup. This method adds the current brand context Poid as a search argument so that only devices belonging to the current brand context are returned. If a set of allowed device statuses has been defined then this method will append the necessary search arguments so that only devices with an allowed status are returned. If you override this class, make sure mSecConn has been initialized. Normally mSecConn is initialized in startSearch before this method is called. If you override or make modifications to this method, be aware of the following. Any time this method throws an exception, use unsetSecondaryConnection to add the connection back to the pool.

Overrides:

setupSearch in class PIASearchPanelBean

Parameters:

sClass - the storable class name which is being sought

res - the fields to be returned in the results

argV - the search arguments

assClasses - the Portal storable class names associated with the search arguments

Throws:

RemoteException - if anything goes wrong