Lotus Instant Messaging/ Web Conferencing ... - IBM Redbooks

RedPanelDiscussionSA PlacesAdminHandler ServerAppService PlaceAdminService ActivityServiceListeneraddPlacesAdminListener(PlacesAdminHandler)addActivityServiceListener(this)addLoginListener(this)loginAsServerApp(String, short, String, int[])loggedIn(LoginEvent)Figure 8-4 Login sequence diagram8.5.2 Creating a persistent Place and Place characteristicsIf the login is successful and the Places Admin Service is available, then theserviceAvailable event in the PlaceAdminHandler class will be triggered. Oncethis event is received, the application starts the process of defining some of thecharacteristics of the Place type that our Place will be created with. The firstcharacteristic we set is the default number of sections in the Place type:public void serviceAvailable(PlacesAdminEvent event) {m_adminService.setDefaultSections(RedPanelDiscussionConstants.PLACE_TYPE,RedPanelDiscussionConstants.NUM_SECTIONS,RedPanelDiscussionConstants.MAX_USERS_IN_SECTION);}The first parameter in the method is the placeType. The concept of Place type issomething that seems to be glossed over in most discussions. A Place type, in anutshell, is a template for a Place which can have preset characteristics, such asthe default number of sections, a default activity, and other activities. In ourexample, the Place type gets created when we call this method. The secondparameter is the number of sections to include in the Place. In the example, weneed six sections (one Lobby, one Queue, and four Audience sections). Bydefault, Sametime will always create one section for the stage, so even thoughwe want seven sections in total, we only request six sections in this method call.The final parameter is the maximum number of users allowed in this section. Wearbitrarily chose 30. Setting the value equal to 0 allows an unlimited number ofusers.206 Lotus Instant Messaging/Web Conferencing (Sametime): Building Sametime-Enabled Applications