Cisco Service Portal インテグレーション ガイド リリース 9.3.2

偏向のない言語

この製品のマニュアルセットは、偏向のない言語を使用するように配慮されています。このマニュアルセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザーインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブランゲージに対する取り組みの詳細は、こちらをご覧ください。

翻訳について

このドキュメントは、米国シスコ発行ドキュメントの参考和訳です。リンク情報につきましては、日本語版掲載時点で、英語版にアップデートがあり、リンク先のページが移動/変更されている場合がありますことをご了承ください。あくまでも参考和訳となりますので、正式な内容については米国サイトのドキュメントを参照ください。

マニュアルのコンテンツ
このマニュアル内で検索
ご利用いただける言語
Download Options

Book Title

Cisco Service Portal インテグレーション ガイド リリース 9.3.2

Chapter Title

JSR ポートレット

検索結果

Updated:
2017年6月18日

章のタイトル： JSR ポートレット

JSR ポートレット

• 「概要」

• 「ポートレットの構造とパッケージ化」

• 「ポートレットの作成」

• 「JSR ポートレット コントローラのコンパイル」

• 「ポートレットの導入」

概要

Service Portal の Portal Manager ソリューションは、JSR ポートレットを通じて外部アプリケーションと統合するための高機能なプラットフォームです。ポータルのフロントエンドでは、フレームワークに Apache Pluto 1.1 ライブラリを使用します。Java Portlet Specification（JSR168、JSR286）規格を満たす API を使用して作成されたポートレットは、Service Portal と共に導入できます。導入すると、Portal Designer に [Third-Party Portlets] と表示され、ポータル ページに追加できるようになります。JSR ポートレットその他のコンテンツを Portal Manager ソリューションでメンテナンスする方法の詳細については、『Cisco Service Portal Designer Guide』を参照してください。

この章では、Portal Manager ソリューション用に JSR ポートレットを作成および導入する際のガイドラインをいくつか示します。章全体を通じて、「MyJSR」というサンプル ポートレットを使用して説明します。ポートレットは、Spring 3.0 Annotation ベースのコントローラおよび Sencha の Ext JS（ポータル フロントエンドの JavaScript フレームワーク）を使用して作成します。

ポートレットの構造とパッケージ化

ポートレット ファイルは JSR 168 または 286 仕様に従って、使用するアプリケーション サーバに適した Web アプリケーション（war）ファイルの形式でパッケージ化する必要があります。一般的なポートレット war ファイルには、サーブレット、リソース バンドル、イメージ、html、jsp、css ファイルなどが含まれます。

JBoss アプリケーション サーバ

「MyJSR.war」という単純なポートレットの構造を示します。

1. css
MyJSR.css
2. images
<ポートレットに必要なカスタム イメージをここに配置できます>
3. js
MyJSRCreatePersonView.js
MyJSREdit.js
MyJSRHelp.js
MyJSRView.js
4. WEB-INF
classes
com
myjsr
MyJSRController.class
config
spring
MyJSRApplicationContext.xml
jsrportlet.properties
log4j.properties
jsp
MyJSREdit.jsp
MyJSRHelp.jsp
MyJSRView_listperson.jsp
MyJSRView_updateperson.jsp
lib
newscale_appclient.jar
tld
c.tld
pluto.tld
portlet.tld
portlet_2_0.tld
portlet-el.tld
portlet-el_2_0.tld
portlet.xml
web.xml
 

このサンプル ポートレットでは、ポートレットが REST API を呼び出して Service Portal からデータを取得するため、lib フォルダに nsAPI java クライアント（newscale_appclient.jar）が含まれています。ポートレットは Service Portal アプリケーションと同じ JVM に導入されるため（導入については、次の項で詳しく説明します）、Pluto ライブラリおよび nsAPI java クライアントが依存するその他のライブラリを lib フォルダに含める必要はありません。

ポートレット関連の設定を指定するために、追加の記述子（portlet.xml）が必要です。

Weblogic アプリケーション サーバ

WebLogic の JSR ポートレット war の構造は似ていますが、Service Portal アプリケーションの外に導入するため、ポートレットが使用するすべてのライブラリを含める必要があります。

nsAPI java クライアントを呼び出し、ポートレットの共通設定を読み取るには、次のようないくつかのライブラリが必要です。ここでは、ポートレットが JSP の JSTL タグおよび Spring ポートレット MVC を使用するため、いくつかのライブラリが必要です。

1. css
MyJSR.css
2. images
<ポートレットに必要なカスタム イメージをここに配置できます>
3. js
MyJSRCreatePersonView.js
MyJSREdit.js
MyJSRHelp.js
MyJSRView.js
4. WEB-INF
classes
com
myjsr
MyJSRController.class
config
spring
MyJSRApplicationContext.xml
jsrportlet.properties
log4j.properties
jsp
MyJSREdit.jsp
MyJSRHelp.jsp
MyJSRView_listperson.jsp
MyJSRView_updateperson.jsp
lib
newscale_appclient.jar
newscale_core.jar
newscale_udkernel.jar
newscale_compbeans.jar  
newscale_conf.jar       
castor-0.9.5.4.jar
commons-beanutils-1.8.3.jar
commons-httpclient-3.1.jar
commons-logging-1.0.4.jar
cxf-2.2.7.jar
ezmorph-1.0.4.jar
json-lib-2.2.2-jdk13.jar
jsr311-api-1.0.jar
neethi-2.0.4.jar
oscache-2.4.jar
standard.jar
wsdl4j-1.6.1.jar
XmlSchema-1.4.6.jar
commons-collections-3.2.1.jar   
commons-lang-2.4.jar
neethi-2.0.4.jar              
castor-0.9.5.4.jar    
jstl.jar       
org.springframework.aop-3.0.2.RELEASE.jar
org.springframework.asm-3.0.2.RELEASE.jar
org.springframework.aspects-3.0.2.RELEASE.jar           
org.springframework.beans-3.0.2.RELEASE.jar  
org.springframework.context-3.0.2.RELEASE.jar           
org.springframework.context.support-3.0.2.RELEASE.jar           
org.springframework.core-3.0.2.RELEASE.jar              
org.springframework.expression-3.0.2.RELEASE.jar                
org.springframework.instrument-3.0.2.RELEASE.jar                
org.springframework.instrument.tomcat-3.0.2.RELEASE.jar         
org.springframework.jdbc-3.0.2.RELEASE.jar              
org.springframework.jms-3.0.2.RELEASE.jar               
org.springframework.spring-library-3.0.2.RELEASE.libd           
org.springframework.test-3.0.2.RELEASE.jar              
org.springframework.transaction-3.0.2.RELEASE.jar               
org.springframework.web-3.0.2.RELEASE.jar
org.springframework.web.portlet-3.0.2.RELEASE.jar               
org.springframework.web.servlet-3.0.2.RELEASE.jar    
org.springframework.web.struts-3.0.2.RELEASE.jar        
tld
c.tld
pluto.tld
portlet.tld
portlet_2_0.tld
portlet-el.tld
portlet-el_2_0.tld
portlet.xml
web.xml

WebSphere アプリケーション サーバ

WebSphere のポートレット war も、Service Portal アプリケーションの外部の Web アプリケーションとして導入されます。

ここでは、WebSphere で動作させるために、いくつかの異なったライブラリ バージョンを使用することに注意してください。

1. css
MyJSR.css
2. images
<ポートレットに必要なカスタム イメージをここに配置できます>
3. js
MyJSRCreatePersonView.js
MyJSREdit.js
MyJSRHelp.js
MyJSRView.js
4. WEB-INF
classes
com
myjsr
MyJSRController.class
config
spring
MyJSRApplicationContext.xml
jsrportlet.properties
log4j.properties
jsp
MyJSREdit.jsp
MyJSRHelp.jsp
MyJSRView_listperson.jsp
MyJSRView_updateperson.jsp
lib
newscale_appclient.jar
castor-0.9.5.4.jar
commons-beanutils-1.8.3.jar
commons-collections-3.2.1.jar
commons-httpclient-3.1.jar
commons-lang-2.4.jar
commons-logging-1.0.4.jar
cxf-2.2.12.jar
ezmorph-1.0.4.jar
json-lib-2.2.2-jdk13.jar
jsr311-api-1.0.jar
neethi-2.0.4.jar
newscale_compbeans.jar
newscale_conf.jar
newscale_core.jar
newscale_udkernel.jar
oscache-2.4.jar
standard.jar
wsdl4j-1.6.1.jar
XmlSchema-1.4.6.jar
jstl.jar
org.springframework.aop-3.0.2.RELEASE.jar
org.springframework.asm-3.0.2.RELEASE.jar
org.springframework.aspects-3.0.2.RELEASE.jar           
org.springframework.beans-3.0.2.RELEASE.jar  
org.springframework.context-3.0.2.RELEASE.jar           
org.springframework.context.support-3.0.2.RELEASE.jar           
org.springframework.core-3.0.2.RELEASE.jar              
org.springframework.expression-3.0.2.RELEASE.jar                
org.springframework.instrument-3.0.2.RELEASE.jar                
org.springframework.instrument.tomcat-3.0.2.RELEASE.jar         
org.springframework.jdbc-3.0.2.RELEASE.jar        
org.springframework.jms-3.0.2.RELEASE.jar      
org.springframework.spring-library-3.0.2.RELEASE.libd           
org.springframework.test-3.0.2.RELEASE.jar              
org.springframework.transaction-3.0.2.RELEASE.jar               
org.springframework.web-3.0.2.RELEASE.jar
org.springframework.web.portlet-3.0.2.RELEASE.jar               
org.springframework.web.servlet-3.0.2.RELEASE.jar      
org.springframework.web.struts-3.0.2.RELEASE.jar            
tld
c.tld
pluto.tld
portlet.tld
portlet_2_0.tld
portlet-el.tld
portlet-el_2_0.tld
portlet.xml
web.xml
 

依存ライブラリ

JSR ポートレット war ファイルに含める必要があるライブラリのセットは、次の表に示すように、アプリケーション サーバに導入した RequestCenter アプリケーション、または Service Portal インストーラ イメージから入手できます。

ファイル名
JBoss
WebLogic
WebSphere

newscale_appclient.jar

RequestCenter.ear

RequestCenter.ear

RequestCenter.ear

newscale_compbeans.jar

該当なし

RequestCenter.ear/RequestCenter.war/WEB-INF/lib

RequestCenter.ear/RequestCenter.war/WEB-INF/lib

newscale_conf.jar

該当なし

RequestCenter.ear/RequestCenter.war/WEB-INF/lib

RequestCenter.ear/RequestCenter.war/WEB-INF/lib

newscale_core.jar

該当なし

RequestCenter.ear/RequestCenter.war/WEB-INF/lib

RequestCenter.ear/RequestCenter.war/WEB-INF/lib

commons-beanutils-1.8.3.jar

該当なし

RequestCenter.ear/RequestCenter.war/WEB-INF/lib

RequestCenter.ear/RequestCenter.war/WEB-INF/lib

commons-collections-3.2.1.jar

該当なし

RequestCenter.ear/RequestCenter.war/WEB-INF/lib

RequestCenter.ear/RequestCenter.war/WEB-INF/lib

commons-lang-2.4.jar

該当なし

RequestCenter.ear/RequestCenter.war/WEB-INF/lib

RequestCenter.ear/RequestCenter.war/WEB-INF/lib

cxf-2.2.7.jar

該当なし

RequestCenter.ear/RequestCenter.war/WEB-INF/lib

該当なし

cxf-2.2.12.jar

該当なし

該当なし

Image/b8b/dist/common（インストーラ イメージ内にあり）

json-lib-2.2.2-jdk13.jar

該当なし

RequestCenter.ear/RequestCenter.war/WEB-INF/lib

RequestCenter.ear/RequestCenter.war/WEB-INF/lib

org.springframework*.jar

該当なし

RequestCenter.ear/RequestCenter.war/WEB-INF/lib

RequestCenter.ear/RequestCenter.war/WEB-INF/lib

pluto-container-2.0.2.jar

該当なし

RequestCenter.ear/RequestCenter.war/WEB-INF/lib

RequestCenter.ear/RequestCenter.war/WEB-INF/lib

pluto-portal-driver-2.0.2.jar

該当なし

RequestCenter.ear/RequestCenter.war/WEB-INF/lib

RequestCenter.ear/RequestCenter.war/WEB-INF/lib

pluto-portal-driver-impl-2.0.2.jar

該当なし

RequestCenter.ear/RequestCenter.war/WEB-INF/lib

IRequestCenter.ear/RequestCenter.war/WEB-INF/lib

pluto-taglib-2.0.2.jar

該当なし

Third/apache/pluto/2.0.2（インストーラ イメージ内にあり）

Third/apache/pluto/2.0.2（インストーラ イメージ内にあり）

portlet-api_2.0_spec-1.0.jar

該当なし

RequestCenter.ear/RequestCenter.war/WEB-INF/lib

RequestCenter.ear/RequestCenter.war/WEB-INF/lib

ポートレットの作成

一般的な JSR ポートレットでは、View、Edit、Help の 3 つのレンダリング モードをサポートする必要があります。さらに、Normal、Minimized、Maximized のウィンドウ状態をサポートする必要があります。

以下に示す MyJSR ポータルの例では、2 つの機能をサポートするユーザ インターフェイスが提供されます。

1. Service Portal ユーザのリストをグリッドで表示します。

 

2. ユーザを追加または更新できます。

 

この要件を満たすために、次に示すサンプル コードには、次の高水準操作が含まれています。

• nsAPI java クライアントを使用して、Service Portal ユーザを取得する

• ユーザの詳細を JSON 形式でユーザ インターフェイスに返す

• Ext JS グリッドで、ブラウザにユーザのリストをレンダリングする

• Ext JS で設計した形式で、ユーザの詳細を表示または入力する

• nsAPI java クライアントを使用して、Service Portal リポジトリのユーザの詳細を追加または更新する

MyJSR.css

ポートレットのコード カスタム スタイルをここで設計できます。

以降で、MyJSR.war 内のコンポーネントそれぞれの内容を見ていきます。

MyJSRCreatePersonView.js

Ext JS を使用して、ユーザを作成するためのフォームを表示するコード例。

/* Code custom JavaScript for the portlet here */
 
Ext.onReady(function() {
var tab2 = new Ext.FormPanel({
id : 'personEditForm',
labelAlign : 'top',
title : 'Person Details - Add',
bodyStyle : 'padding:5px',
width : 600,
renderTo : MyJSREditDiv,
items : [{
layout : 'column',
border : false,
items : [{
columnWidth : .5,
layout : 'form',
border : false,
items : [{
xtype : 'textfield',
fieldLabel : 'First Name',
value : personListObj.firstName,
name : 'firstName',
anchor : '95%'
}, {
xtype : 'textfield',
fieldLabel : 'Login Name',
value : personListObj.login,
name : 'login',
anchor : '95%'
}, {
xtype : 'textfield',
fieldLabel : 'Home OU',
name : 'homeOrganizationalUnitName',
value : personListObj.homeOrganizationalUnitName,
anchor : '95%'
}, {
xtype : 'textfield',
fieldLabel : 'Timezone',
name : 'timeZoneName',
value : personListObj.timeZoneName,
anchor : '95%'
}]
}, {
columnWidth : .5,
layout : 'form',
border : false,
items : [{
xtype : 'textfield',
fieldLabel : 'Last Name',
name : 'lastName',
value : personListObj.lastName,
anchor : '95%'
},{
xtype : 'textfield',
fieldLabel : 'Email',
name : 'email',
value : personListObj.email,
vtype : 'email',
anchor : '95%'
}, {
xtype : 'textfield',
fieldLabel : 'Language',
name : 'languageName',
value : personListObj.languageName,
anchor : '95%'
}]
}]
}, {
xtype : 'tabpanel',
plain : true,
activeTab : 0,
height : 235,
defaults : {
bodyStyle : 'padding:10px'
},
items : [{
title : 'Address',
layout : 'form',
defaults : {
width : 230
},
defaultType : 'textfield',
items : [{
fieldLabel : 'Business',
name : 'businessAddress',
disabled : true
}, {
fieldLabel : 'Home',
name : 'homeAddress',
disabled : true
}]
}, {
title : 'Contacts',
layout : 'form',
defaults : {
width : 230
},
defaultType : 'textfield',
items : [{
fieldLabel : 'Business',
name : 'businessPhone',
disabled : true
}, {
fieldLabel : 'Home',
name : 'homePhone',
disabled : true
}, {
fieldLabel : 'Mobile',
name : 'mobilePhone',
disabled : true
}, {
fieldLabel : 'Fax',
name : 'faxNumber',
disabled : true
}]
}]
}],
 
buttons : [{
text : 'Save',
handler : function() {
Ext.getCmp("personEditForm").getForm().submit({
url : addPersonActionUrl,
params : {},
success : function(form, action) {
var responseObj = Ext.util.JSON.decode(action.response.responseText);
if(responseObj.success == "true")
Ext.Msg.alert('Success', responseObj.successMsg);
else
Ext.Msg.alert('Error', responseObj.errorMsg);
}
});
}
},{
text : 'Cancel',
handler : function() {
window.location=viewPersonUrl;
}
}]
});
});
 

MyJSREdit.js

この JavaScript を使用すると、ポートレット編集モード用のカスタム コードを追加できます。

/* Code custom JavaScript for the Portlet here */
 
Ext.onReady(function() {
 
});
 

MyJSRHelp.js

この JavaScript を使用すると、ポートレット編集モード用のカスタム コードを追加できます。

/* Code custom JavaScript for the Portlet here */
 
Ext.onReady(function() {
 
});
 

MyJSRView.js

Ext JS グリッドにユーザを表示する JavaScript の例。

/* Code custom JavaScript for the Portlet here */
Ext.onReady(function() {
// Demonstrates how to getUser info from Java Script and set it to div
varLogin=document.getElementById('MyJSRLoginNameDiv');
Login.innerHTML=nsAPP_CurrentUserLoginName;
varFirstName=document.getElementById('MyJSRFirstNameDiv');
FirstName.innerHTML=nsAPP_CurrentUserFirstName;
varLastName=document.getElementById('MyJSRLastNameDiv');
LastName.innerHTML=nsAPP_CurrentUserLastName;
varHomeOU=document.getElementById('MyJSRHomeOUDiv');
HomeOU.innerHTML=nsAPP_CurrentUserHomeOuId;
var PersonID=document.getElementById('MyJSRPersonIDDiv');
PersonID.innerHTML=nsAPP_CurrentUserId;
 
var pid = portletId.substr(pidPrefix.length);
if (Ext.getCmp(pid).height && Ext.getCmp(pid).height >= 29) {
var gridHeight = Ext.getCmp(pid).height - 29;
}
 
var gridStore = new Ext.data.JsonStore({
proxy : new Ext.data.HttpProxy({
url : pagingUrl,
timeout : connectionTimeOut
}),
autoLoad: {params:{start: 0, limit: defaultRecordSize}},
root: 'rows',
totalProperty: 'results',
fields : [{
name : 'firstName',
type : 'string'
}, {
name : 'lastName',
type : 'string'
}, {
name : 'email',
type : 'string'
}, {
name : 'homeOrganizationalUnitName',
type : 'string'
}, {
name : 'login',
type : 'string'
}, {
name : 'timeZoneName',
type : 'string'
}, {
name : 'languageName',
type : 'string'
}, {
name : 'businessPhone',
type : 'string'
}, {
name : 'homePhone',
type : 'string'
}, {
name : 'mobilePhone',
type : 'string'
}, {
name : 'faxNumber',
type : 'string'
}, {
name : 'businessAddress',
type : 'string'
}, {
name : 'homeAddress',
type : 'string'
}]
});
gridStore.load();
 
var expander = new Ext.ux.grid.RowExpander({
tpl : new Ext.Template(
'<h2 class="title">Address</h2><table>',
'<tr><td width=400><b>Business</b> {businessAddress}</td>',
'<td width=400><b>Home</b>{homeAddress}</td></tr></table>',
'<h2 class="title">Contact</h2><table>',
'<tr><td width=400><b>Business</b> {businessPhone}</td>',
'<td width=400><b>Home</b> {homePhone}</td></tr>',
'<tr><td width=400><b>Mobile</b> {mobilePhone}</td>',
'<td width=400><b>Fax</b> {faxNumber}</td></tr></table>')
});
 
var gridColModel = new Ext.grid.ColumnModel({
defaults : {
sortable : true,
autoWidth : true
},
columns : [{
header : "First Name",
dataIndex : 'firstName'
}, {
header : "Last Name",
dataIndex : 'lastName'
}, {
header : "Email",
dataIndex : 'email'
}, {
header : "Home OU",
dataIndex : 'homeOrganizationalUnitName'
}, {
header : "Login Name",
dataIndex : 'login'
}, {
header : "Timezone",
dataIndex : 'timeZoneName'
}, {
header : "Language",
dataIndex : 'languageName'
}]
});
 
var gridConfig = {
renderTo : MyJSREditDiv,
width : "100%",
layout : 'fit',
store : gridStore,
cm : gridColModel,
loadMask: true,
autoWidth : true,
plugins : expander,
tbar : [{
text : 'Create Person',
iconCls : 'add',
handler : function() {
window.location=createNewPersonActionUrl;
}
},'-'],
bbar : new Ext.PagingToolbar({
pageSize : defaultRecordSize,
store : gridStore,
displayInfo : true,
params:{
start: 0,
limit: defaultRecordSize
}
})
};
 
if ('maximized' == portletWindowState) {
gridConfig.height = document.documentElement.clientHeight - 188;
} elseif ('normal' == portletWindowState) {
var viewConfig = {
forceFit : true
};
gridConfig.viewConfig = viewConfig;
 
if (gridHeight && gridHeight > -1) {
gridConfig.height = gridHeight;
} else {
gridConfig.autoHeight = true;
}
}
 
var grid = new Ext.grid.GridPanel(gridConfig);
});
 

portlet.xml

ポートレット仕様の例。portlet-class は、init-params のペア contextConfigLocation と nsContentPortlet とともに設定する必要があります（nsContentPortlet は、常に「false」に設定します）。

<?xmlversion="1.0"encoding="UTF-8"?>
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements.See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License.You may obtain a copy of the License at
 
http:www.apache.org/licenses/LICENSE-2.0
 
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied.
 
See the License for the specific language governing permissions and
limitations under the License.
-->
<portlet-app
xmlns="http:java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd"
version="1.0"
xmlns:xsi="http:www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http:java.sun.com/xml/ns/portlet/portlet-app_1_0.xsd
http:java.sun.com/xml/ns/portlet/portlet-app_1_0.xsd">
<portlet>
<description>MyJSR Description</description>
<portlet-name>nsMyJSR</portlet-name>
<display-name>My JSR Portlet</display-name>
<portlet-class>org.springframework.web.portlet.DispatcherPortlet</portlet-class>
<init-param>
<name>contextConfigLocation</name>
<value>/WEB-INF/classes/config/spring/MyJSRApplicationContext.xml</value>
</init-param>
<init-param>
<name>nsContentPortlet</name>
<value>false</value>
</init-param>
<expiration-cache>-1</expiration-cache>
<supports>
<mime-type>text/html</mime-type>
<portlet-mode>VIEW</portlet-mode>
<portlet-mode>EDIT</portlet-mode>
<portlet-mode>HELP</portlet-mode>
</supports>
<portlet-info>
<title>My JSR Portlet</title>
</portlet-info>
</portlet>
</portlet-app>
 

web.xml

サーブレットによる展開記述子の例。ポータル サーバ（この例では Apache Pluto）でサーブレットのマッピングが必要です。

<?xmlversion="1.0"encoding="UTF-8"?>
<!DOCTYPEweb-appPUBLIC"-Sun Microsystems, Inc. DTD Web Application 2.3EN""http:java.sun.com/dtd/web-app_2_3.dtd">
<web-app>
<display-name>My JSR Portlet Application</display-name>
<description>My JSR Portlet</description>
 
<!-- Resources bundle base class -->
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>
/WEB-INF/classes/config/spring/MyJSRApplicationContext.xml
</param-value>
</context-param>
 
<context-param>
<param-name>parameter-name</param-name>
<param-value>parameter-value</param-value>
</context-param>
 
<servlet>
<servlet-name>ViewRendererServlet</servlet-name>
<servlet-class>
org.springframework.web.servlet.ViewRendererServlet
</servlet-class>
</servlet>
 
<servlet>
<servlet-name>MyJSR</servlet-name>
<servlet-class>org.apache.pluto.container.driver.PortletServlet</servlet-class>
<init-param>
<param-name>portlet-name</param-name>
<param-value>MyJSR</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
 
<servlet-mapping>
<servlet-name>ViewRendererServlet</servlet-name>
<url-pattern>/WEB-INF/servlet/view</url-pattern>
</servlet-mapping>
 
<servlet-mapping>
<servlet-name>MyJSR</servlet-name>
<url-pattern>/PlutoInvoker/nsMyJSR</url-pattern>
</servlet-mapping>
 
<!- Declare Tag libraries that are used in which are going to use in JSP pages-->
<taglib>
<taglib-uri>http://portals.apache.org/pluto</taglib-uri>
<taglib-location>/WEB-INF/tld/pluto.tld</taglib-location>
</taglib>
 
<taglib>
<taglib-uri>http://java.sun.com/portlet_2_0</taglib-uri>
<taglib-location>/WEB-INF/tld/portlet_2_0.tld</taglib-location>
</taglib>
 
<taglib>
<taglib-uri>/WEB-INF/tld/c.tld</taglib-uri>
<taglib-location>/WEB-INF/tld/c.tld</taglib-location>
</taglib>
 
<taglib>
<taglib-uri>http://java.sun.com/portlet</taglib-uri>
<taglib-location>/WEB-INF/tld/portlet.tld</taglib-location>
</taglib>
 
<taglib>
<taglib-uri>http://portals.apache.org/pluto/portlet-el</taglib-uri>
<taglib-location>/WEB-INF/tld/portlet-el.tld</taglib-location>
</taglib>
 
<taglib>
<taglib-uri>http://portals.apache.org/pluto/portlet-el_2_0</taglib-uri>
<taglib-location>/WEB-INF/tld/portlet-el_2_0.tld</taglib-location>
</taglib>
 
</web-app>
 

MyJSREdit.jsp

ポートレット編集モード用の JSP。

<%
/**
* Copyright (c) 2012, Cisco Systems, Inc. All rights reserved.
*/
%>
 
<%@tagliburi="http:java.sun.com/portlet"prefix="portlet"%>
<%@taglibprefix="portlet2"uri="http:java.sun.com/portlet_2_0"%>
<%@taglibprefix="c"uri="/WEB-INF/tld/c.tld"%>
 
<% String contextPath = request.getContextPath(); %>
 
<!-- This is for IE -->
<scripttype="text/javascript">
if(document.createStyleSheet) {
document.createStyleSheet('<%= response.encodeURL(contextPath + "/css/MyJSR.css") %>');
}
else {
var styles = "@import url('<%= response.encodeURL(contextPath + "/css/MyJSR.css") %>');";
var newSS=document.createElement('link');
newSS.rel='stylesheet';
newSS.href='data:text/css,'+escape(styles);
document.getElementsByTagName("head")[0].appendChild(newSS);
}
</script>
 
<!-- This is foFirefox -->
<linkrel="stylesheet"type="text/css"href="<%= response.encodeURL(contextPath + "/css/MyJSR.css") %>"></link>
 
<script>
var head = document.getElementsByTagName('head')[0];
var script = document.createElement('script');
script.type = 'text/javascript';
script.src = '<%= response.encodeURL(contextPath + "/js/MyJSREdit.js") %>';
head.appendChild(script);
</script>
 
<!-- Write your JSP Code for Portlet Edit here -->
<c:iftest="${portletWindowState == 'NORMAL' or portletWindowState == 'normal'}">
Portlet Mode = <c:outvalue='${portletMode}'/>
Portlet Window State = <c:outvalue='${portletWindowState}'/>
</c:if>
 
<c:iftest="${portletWindowState == 'MINIMIZED' or portletWindowState == 'minimized'}">
Portlet Mode = <c:outvalue='${portletMode}'/>
Portlet Window State = <c:outvalue='${portletWindowState}'/>
</c:if>
 
<c:iftest="${portletWindowState == 'MAXIMIZED' or portletWindowState == 'maximized'}">
Portlet Mode = <c:outvalue='${portletMode}'/>
Portlet Window State = <c:outvalue='${portletWindowState}'/>
</c:if>
 
<divid="MyJSREditDiv-<portlet:namespace/>"class="x-grid-mso"></div>
 
<script>
var MyJSREditDiv = 'MyJSREditDiv-<portlet:namespace/>';
var addPersonActionUrl = '<portlet2:resourceURL id="addPersonData" escapeXml="false" />';
var personListObj = Ext.util.JSON.decode('<c:out value="${PersonData}" escapeXml="false"/>');
</script>
 

MyJSRHelp.jsp

ポートレット ヘルプ モード用の JSP。

<%
/**
* Copyright (c) 2012, Cisco Systems, Inc. All rights reserved.
*/
%>
 
<%@tagliburi="http:java.sun.com/portlet"prefix="portlet"%>
<%@taglibprefix="c"uri="/WEB-INF/tld/c.tld"%>
 
<% String contextPath = request.getContextPath(); %>
 
<!-- This is for IE -->
<scripttype="text/javascript">
if(document.createStyleSheet) {
document.createStyleSheet("<%= response.encodeURL(contextPath + "/css/MyJSR.css") %>");
}
else {
var styles = "@import url('<%= response.encodeURL(contextPath + "/css/MyJSR.css") %>');";
var newSS=document.createElement('link');
newSS.rel='stylesheet';
newSS.href='data:text/css,'+escape(styles);
document.getElementsByTagName("head")[0].appendChild(newSS);
}
</script>
 
<!-- This is foFirefox -->
<linkrel="stylesheet"type="text/css"href="<%= response.encodeURL(contextPath + "/css/MyJSR.css") %>"></link>
 
<script>
var head = document.getElementsByTagName('head')[0];
var script = document.createElement('script');
script.type = 'text/javascript';
script.src = '<%= response.encodeURL(contextPath + "/js/MyJSRHelp.js") %>';
head.appendChild(script);
</script>
 
<!-- Write your JSP Code for Portlet Help here -->
<c:iftest="${portletWindowState == 'NORMAL' or portletWindowState == 'normal'}">
Portlet Mode = <c:outvalue='${portletMode}'/>
Portlet Window State = <c:outvalue='${portletWindowState}'/>
</c:if>
 
<c:iftest="${portletWindowState == 'MINIMIZED' or portletWindowState == 'minimized'}">
Portlet Mode = <c:outvalue='${portletMode}'/>
Portlet Window State = <c:outvalue='${portletWindowState}'/>
</c:if>
 
<c:iftest="${portletWindowState == 'MAXIMIZED' or portletWindowState == 'maximized'}">
Portlet Mode = <c:outvalue='${portletMode}'/>
Portlet Window State = <c:outvalue='${portletWindowState}'/>
</c:if>
 
<divid="MyJSRHelpDiv-<portlet:namespace/>"class="x-grid-mso"></div>
 
<script>
var MyJSRHelpDiv = 'MyJSRHelpDiv-<portlet:namespace/>';
</script>
 

MyJSRView_listperson.jsp

ポートレット表示モード用の JSP コード。

<%
/**
* Copyright (c) 2012, Cisco Systems, Inc. All rights reserved.
*/
%>
 
<%@tagliburi="http:java.sun.com/portlet"prefix="portlet"%>
<%@taglibprefix="portlet2"uri="http:java.sun.com/portlet_2_0"%>
<%@taglibprefix="c"uri="/WEB-INF/tld/c.tld"%>
 
<% String contextPath = request.getContextPath(); %>
 
<!-- This is for IE -->
<scripttype="text/javascript">
if(document.createStyleSheet) {
document.createStyleSheet('<%= response.encodeURL(contextPath + "/css/MyJSR.css") %>');
}
else {
var styles = "@import url('<%= response.encodeURL(contextPath + "/css/MyJSR.css") %>');";
var newSS=document.createElement('link');
newSS.rel='stylesheet';
newSS.href='data:text/css,'+escape(styles);
document.getElementsByTagName("head")[0].appendChild(newSS);
}
var portletId = 'portlet-container-<c:out value="${portlet}"/>';
var pidPrefix = "portlet-container-";
var portletWindowState = "<c:out value='${portletWindowState}'/>";
var portletMode = "<c:out value='${portletMode}'/>";
var defaultRecordSize = <c:out value='${defaultRecordSize}'/>;
var nsappPersonViewDiv = 'nsappPersonViewDiv-<portlet:namespace/>';
var pagingUrl = '<portlet2:resourceURL escapeXml="false" />';
var connectionTimeOut = <c:out value='${connectionTimeOut}'/>;
</script>
 
<!-- This is foFirefox -->
<linkrel="stylesheet"type="text/css"href="<%= response.encodeURL(contextPath + "/css/MyJSR.css") %>"></link>
 
<script>
var head = document.getElementsByTagName('head')[0];
var script = document.createElement('script');
script.type = 'text/javascript';
script.src = '<%= response.encodeURL(contextPath + "/js/MyJSRView.js") %>';
head.appendChild(script);
</script>
 
<!-- Write your JSP Code for Portlet Edit here -->
<c:iftest="${portletWindowState == 'NORMAL' or portletWindowState == 'normal'}">
<!--PortletMode = <c:out value='${portletMode}'/>
Portlet Window State = <c:out value='${portletWindowState}'/> -->
</c:if>
 
<c:iftest="${portletWindowState == 'MINIMIZED' or portletWindowState == 'minimized'}">
<!--Portlet Mode = <c:out value='${portletMode}'/>
Portlet Window State = <c:out value='${portletWindowState}'/> -->
</c:if>
 
<c:iftest="${portletWindowState == 'MAXIMIZED' or portletWindowState == 'maximized'}">
<!--Portlet Mode = <c:out value='${portletMode}'/>
Portlet Window State = <c:out value='${portletWindowState}'/>-->
</c:if>
 
<!-Un-comment this to get User Info from the Portlet Controller that sets user info in model
Logged In User (<c:out value="${userName}" escapeXml="false"/>): <c:out value="${firstName}" escapeXml="false"/>&nbsp;,&nbsp; <c:out value="${lastName}" escapeXml="false"/>&nbsp;,&nbsp;<c:out value="${PersonId}" escapeXml="false"/>&nbsp;,&nbsp;<c:out value="${HomeOUId}" escapeXml="false"/>
-->
 
<!-Write declare divs to display user info -->
<div>Logged In User (<div id="MyJSRLoginNameDiv" style="text-align:right;display:inline;width:100%;"><span style="padding-left:20px;"></span></div>)&nbsp;:&nbsp;<div id="MyJSRFirstNameDiv" style="text-align:right;display:inline;width:100%;"><span></span></div>&nbsp;,&nbsp;
<divid="MyJSRLastNameDiv" style="text-align:right;display:inline;width:100%;"><span style="padding-left:20px;"></span></div>
</div>
<div>HomeOUId&nbsp;:&nbsp;<div id="MyJSRHomeOUDiv" style="text-align:right;display:inline;width:100%;"><span style="padding-left:20px;"></span></div>&nbsp;,&nbsp;
PersonId&nbsp;:&nbsp;<div id="MyJSRPortletPersonIDDiv" style="text-align:right;display:inline;width:100%;"><span style="padding-left:20px;"></span>
</div>
 
<divid="MyJSREditDiv-<portlet:namespace/>"class="x-grid-mso"></div>
 
<script>
var MyJSREditDiv = 'MyJSREditDiv-<portlet:namespace/>';
var createNewPersonActionUrl = '<portlet:renderURL><portlet:param name="formAction" value="createNewPerson" /></portlet:renderURL>';
var addPersonActionUrl = '<portlet2:resourceURL id="addPersonData" escapeXml="false" />';
var personListObj = Ext.util.JSON.decode('<c:out value="${PersonData}" escapeXml="false"/>');
</script>
 

MyJSRView_updateperson.jsp

ユーザ更新操作のデモ用 JSP コードの例。

<%
/**
* Copyright (c) 2012, Cisco Systems, Inc. All rights reserved.
*/
%>
 
<%@tagliburi="http:java.sun.com/portlet"prefix="portlet"%>
<%@taglibprefix="portlet2"uri="http:java.sun.com/portlet_2_0"%>
<%@taglibprefix="c"uri="/WEB-INF/tld/c.tld"%>
 
<%String contextPath = request.getContextPath(); %>
 
<!-- This is foFirefox -->
<linkrel="stylesheet"type="text/css"href="<%= response.encodeURL(contextPath + "/css/MyJSR.css") %>"></link>
 
<!-- This is for IE -->
<scripttype="text/javascript">
if(document.createStyleSheet) {
document.createStyleSheet("<%= response.encodeURL(contextPath + "/css/MyJSR.css") %>");
}
else {
var styles = "@import url('<%= response.encodeURL(contextPath + "/css/MyJSR.css") %>');";
var newSS=document.createElement('link');
newSS.rel='stylesheet';
newSS.href='data:text/css,'+escape(styles);
document.getElementsByTagName("head")[0].appendChild(newSS);
}
</script>
 
<script>
var head = document.getElementsByTagName('head')[0];
var script = document.createElement('script');
script.type = 'text/javascript';
script.src = '<%= response.encodeURL(contextPath + "/js/MyJSRCreatePersonView.js") %>';
head.appendChild(script);
</script>
 
<!-- Write your JSP Code for Portlet View here -->
<c:iftest="${portletWindowState == 'NORMAL' or portletWindowState == 'normal'}">
<!--Portlet Mode = <c:out value='${portletMode}'/>
Portlet Window State = <c:out value='${portletWindowState}'/> -->
</c:if>
 
<c:iftest="${portletWindowState == 'MINIMIZED' or portletWindowState == 'minimized'}">
<!--Portlet Mode = <c:out value='${portletMode}'/>
Portlet Window State = <c:out value='${portletWindowState}'/> -->
</c:if>
 
<c:iftest="${portletWindowState == 'MAXIMIZED' or portletWindowState == 'maximized'}">
<!--Portlet Mode = <c:out value='${portletMode}'/>
Portlet Window State = <c:out value='${portletWindowState}'/>-->
</c:if>
 
<divid="MyJSREditDiv-<portlet:namespace/>"class="x-grid-mso"></div>
<script>
var MyJSREditDiv = 'MyJSREditDiv-<portlet:namespace/>';
var addPersonActionUrl = '<portlet2:resourceURL id="addPersonData" escapeXml="false" />';
var viewPersonUrl = '<portlet:renderURL></portlet:renderURL>';
var personListObj = Ext.util.JSON.decode('<c:out value="${PersonData}" escapeXml="false"/>');
</script>
 

MyJSRController.java

java ポートレット コントローラを作成する一般的な手順は、次のとおりです。

ステップ 1 3 つのポートレット モード（View、Edit、および Help）のハンドラ コードを記述します。

ステップ 2 3 つのポートレット ビュー（Normal、Minimized、Maximized）のハンドラ コードを記述します。

ステップ 3 Service Portal エンティティを処理または表示する JSR ポートレットでは、nsAPI クライアントを使用して、関連する REST API をポートレット コントローラで呼び出すことができます。

a. nsAPI クライアント API の参照を取得します。

b. nsAPI クライアントを呼び出して、必要な Service Portal エンティティのインスタンスのリストを取得します。

c. オプションで、現在ログインしているユーザの詳細（ユーザ ID、名、姓など）を取得します。

ステップ 4 インスタンスをグリッドまたはその他の形式でレンダリングします（この例では、Ext JS グリッドの nsAPI でページングをする方法も示します）。

 

package com.myjsr;
 
importjava.io.IOException;
importjava.util.ArrayList;
importjava.util.HashMap;
importjava.util.Iterator;
importjava.util.List;
import java.util.Map;
importjava.util.Properties;
 
importjavax.portlet.RenderRequest;
importjavax.portlet.RenderResponse;
importjavax.portlet.ResourceRequest;
importjavax.portlet.ResourceResponse;
 
importnet.sf.json.JSON;
importnet.sf.json.JSONSerializer;
importjavax.portlet.ActionRequest;
importjavax.servlet.http.HttpSession;
importjavax.portlet.PortletURL;
importorg.apache.commons.collections.map.MultiValueMap;
importorg.apache.commons.lang.StringEscapeUtils;
importorg.apache.commons.lang.StringUtils;
importorg.springframework.ui.Model;
importorg.springframework.web.portlet.ModelAndView;
importorg.springframework.web.bind.annotation.ModelAttribute;
importorg.springframework.web.bind.annotation.RequestMapping;
importorg.springframework.web.portlet.bind.annotation.ResourceMapping;
importorg.springframework.web.bind.annotation.RequestParam;
 
importcom.newscale.comps.conf.domain.AppParamUtil;
importcom.newscale.nsapi.directory.person.Person;
importcom.newscale.nsapi.directory.person.PersonList;
importcom.newscale.nsapiclient.NSApiClient;
importcom.newscale.nsapiclient.NSApiClientConstants;
importcom.newscale.nsapiclient.NSApiClientFactory;
importcom.newscale.portlets.GenericNewScaleSpringPortletBase;
 
 
/**
*MyJSRController
*/
publicclass MyJSRController extends GenericNewScaleSpringPortletBase {
privatestaticfinal String configPropsFile = "jsrportlet.properties";
privatestaticfinal String viewPageList = "MyJSRView_listperson";
privatestaticfinal String viewPageUpdate = "MyJSRView_updateperson";
privatestaticfinal String editPage = "MyJSREdit";
privatestaticfinal String helpPage = "MyJSRHelp";
private NSApiClient nsApiClient = getNSApiClient();
 
public NSApiClient getNsApiClient() {
return nsApiClient;
}
 
public void setNsApiClient(NSApiClient nsApiClient) {
this.nsApiClient = nsApiClient;
}
 
public String viewNormal(RenderRequest request, RenderResponse response, Model model) {
try {
super.viewNormal(request, response, model);
getLoginUsername(request , model);
} catch(Exception e){
e.printStackTrace();
}
 
return doView(request, response, model);
}
 
public String viewMinimized(RenderRequest request, RenderResponse response, Model model) {
try {
super.viewMinimized(request, response, model);
} catch(Exception e){
e.printStackTrace();
}
return viewPageList;
}
 
public String viewMaximized(RenderRequest request, RenderResponse response, Model model) {
try {
super.viewMaximized(request, response, model);
getLoginUsername(request , model);
} catch(Exception e){
e.printStackTrace();
}
 
return doView(request, response, model);
}
 
private void getLoginUsername(RenderRequest request , Model model){
Properties properties = getConfigProperties(configPropsFile);
nsApiClient.login(properties.getProperty("BASE_URL"), request.getPortletSession().getId());
// Get Currently Logged-in user from nsAPI client
Person persons = nsApiClient.getDirectory().getCurrentUser();
 
// Set user info into model so that JSP can access it
model.addAttribute("PersonID", persons.getPersonId());
model.addAttribute("HomeOUId", persons.getHomeOrganizationalUnitId());
model.addAttribute("firstName", persons.getFirstName());
model.addAttribute("lastName", persons.getLastName());
model.addAttribute("userName", persons.getLogin());
}
 
private String doView(RenderRequest request, RenderResponse response, Model model) {
try {
Properties properties = getConfigProperties(configPropsFile);
nsApiClient.login(properties.getProperty("BASE_URL"), request.getPortletSession().getId());
 
int defaultRecordSize = AppParamUtil.getInstance().getMaxMaxPagingSizeInNSApi();
model.addAttribute("defaultRecordSize", "" + defaultRecordSize);
int connectionTimeOut = 0;
if (AppParamUtil.getInstance().isParamExists((AppParamUtil.SESSION_TIMEOUT))) {
connectionTimeOut = AppParamUtil.getInstance().getIntegerParam(AppParamUtil.SESSION_TIMEOUT);
}
if (connectionTimeOut < 1) {
connectionTimeOut = 20;
}
model.addAttribute("connectionTimeOut", "" + connectionTimeOut * 1000 * 60);
 
String formAction = request.getParameter("formAction");
String personIdStr = request.getParameter("personId");
 
if (null != formAction && formAction.equals("createNewPerson") ) {
showAddPersonPage(request, response, model);
return viewPageUpdate;
} elseif(null != personIdStr){
editPerson(request, response, model, new Integer(personIdStr).intValue());
return viewPageUpdate;
} else {
return viewPageList;
}
} catch (Exception e){
e.printStackTrace();
}
returnnull;
}
 
@RequestMapping("VIEW")
@ResourceMapping
public ModelAndView doPagingOrSavePerson(ResourceRequest request, ResourceResponse response, Person person)
throws Exception {
String instanceName= getInstanceName(request.getWindowID());
Save Button is clicked while adding person
if ("createNewPerson".equals(request.getParameter("formAction")) || null != request.getParameter("personId")) {
addPersonData(person ,request, response );
} elseif (null != request.getParameter("start") &&null != request.getParameter("limit")) { Paging
int startInt = Integer.parseInt(request.getParameter("start")) + 1; extjs sends 1 less than what nsAPI wants
int limit = Integer.parseInt(request.getParameter("limit")) + 1; extjs sends 1 less than what nsAPI wants
try {
if (request.getWindowState().equals(request.getWindowState().NORMAL)) {
doPagingInternal(request, response, instanceName, 1, startInt, limit);
}
if (request.getWindowState().equals(request.getWindowState().MAXIMIZED)) {
doPagingInternal(request, response, instanceName, 2, startInt, limit);
}
} catch (Exception e) {
e.printStackTrace();
}
}
returnnull;
}
 
private void doPagingInternal(ResourceRequest request, ResourceResponse response, String portletInst,
int windowStateInt, int start, int limit) throws Exception {
Map<String, Object> jsonMap = new HashMap<String, Object>();
List recordList = newArrayList();
int totalCount = 1;
String editPersonUrl = request.getParameter("editPersonUrl");
MultiValueMap paramsmap = new MultiValueMap();
paramsmap.put(NSApiClientConstants.QUERYPARAM_START_ROW, "" + start);
paramsmap.put(NSApiClientConstants.QUERYPARAM_RECORD_SIZE, "" + limit);
PersonList personList = nsApiClient.getDirectory().getPeople(paramsmap);
if(personList.getPeople() != null) {
for(Iterator iterator = personList.getPeople().iterator(); iterator.hasNext();) {
Person portalPerson = (Person) iterator.next();
portalPerson.setPersonURL(StringEscapeUtils.escapeXml(portalPerson.getPersonURL()));
PortletURL editPersonURL = response.createRenderURL();
editPersonURL.setParameter("personId", "" + portalPerson.getPersonId());
String firstNameUrl = "<a href='" + editPersonURL.toString() + "'>" + portalPerson.getFirstName() + "</a>";
String lastNameUrl = "<a href='" + editPersonURL.toString() + "'>" + portalPerson.getLastName() + "</a>";
portalPerson.setFirstName(firstNameUrl);
portalPerson.setLastName(lastNameUrl);
recordList.add(portalPerson);
}
jsonMap.put("success", "true");
jsonMap.put("results", personList.getTotalCount());
jsonMap.put("rows", recordList);
JSON json = (JSON) JSONSerializer.toJSON(jsonMap);
String jsonStr = json.toString();
 
response.setContentType("text/plain");
response.getPortletOutputStream().write(jsonStr.getBytes());
response.getPortletOutputStream().flush();
}
}
 
 
private ModelAndView addPersonData(@ModelAttribute("personData") Person person,
ResourceRequest request, ResourceResponse response) throws Exception {
Add Person from Form Data in Request
Map jsonMap = newHashMap();
try {
Person Updateperson = nsApiClient.getDirectory().updatePerson(person);
jsonMap.put("success", "true");
jsonMap.put("successMsg", "Person Added/Updated Successfully");
jsonMap.put("rows", Updateperson);
JSON json = (JSON) JSONSerializer.toJSON(jsonMap);
String jsonStr = json.toString();
 
response.setContentType("text/plain");
response.getPortletOutputStream().write(jsonStr.getBytes());
response.getPortletOutputStream().flush();
} catch (Exception e) {
e.printStackTrace();
jsonMap.put("success", "false");
jsonMap.put("errorMsg", "Person Add/Update Failed : " + e.getMessage());
 
JSON json2 = (JSON) JSONSerializer.toJSON(jsonMap);
String jsonStr2 = json2.toString();
 
response.setContentType("text/plain");
response.getPortletOutputStream().write(jsonStr2.getBytes());
response.getPortletOutputStream().flush();
}
 
returnnull;
}
 
private void editPerson(RenderRequest request, RenderResponse response, Model model, int personId) {
int person = personId;
Map<String, Object> jsonMap = new HashMap<String, Object>();
try {
Person persons = nsApiClient.getDirectory().getPersonById(person);
persons.setPersonURL(StringEscapeUtils.escapeXml(persons.getPersonURL()));
JSON json = (JSON) JSONSerializer.toJSON(persons);
String jsonStr = json.toString();
model.addAttribute("PersonData", jsonStr);
} catch (Exception e) {
e.printStackTrace();
}
}
 
private String showAddPersonPage(RenderRequest request, RenderResponse response, Model model) {
Person DummyPerson = newPerson();
DummyPerson.setPersonURL(StringEscapeUtils.escapeXml(DummyPerson.getPersonURL()));
JSON json1 = (JSON) JSONSerializer.toJSON(DummyPerson);
String jsonStr1 = json1.toString();
model.addAttribute("PersonData", jsonStr1);
 
return viewPageUpdate;
}
 
public String editNormal(RenderRequest request, RenderResponse response, Model model) {
try {
super.editNormal(request, response, model);
} catch(Exception e){
e.printStackTrace();
}
return editPage;
}
 
public String editMinimized(RenderRequest request, RenderResponse response, Model model) {
try {
super.editMinimized(request, response, model);
} catch(Exception e){
e.printStackTrace();
}
return editPage;
}
 
public String editMaximized(RenderRequest request, RenderResponse response, Model model) {
try {
super.editMaximized(request, response, model);
} catch(Exception e){
e.printStackTrace();
}
return editPage;
}
 
public String helpNormal(RenderRequest request, RenderResponse response, Model model) {
try {
super.helpNormal(request, response, model);
} catch(Exception e){
e.printStackTrace();
}
return helpPage;
}
 
public String helpMinimized(RenderRequest request, RenderResponse response, Model model) {
try {
super.helpMinimized(request, response, model);
} catch(Exception e){
e.printStackTrace();
}
return helpPage;
}
 
public String helpMaximized(RenderRequest request, RenderResponse response, Model model) {
try {
super.helpMaximized(request, response, model);
} catch(Exception e){
e.printStackTrace();
}
return helpPage;
}
 
private NSApiClient getNSApiClient() {
return NSApiClientFactory.getInstance();
}
}
 

MyJSRApplicationContext.xml

ポートレット用の Spring アプリケーション コンテキスト XML。

<?xmlversion="1.0"encoding="UTF-8"?>
<beansxmlns="http:www.springframework.org/schema/beans"
xmlns:xsi="http:www.w3.org/2001/XMLSchema-instance"xmlns:p="http:www.springframework.org/schema/p"
xmlns:context="http:www.springframework.org/schema/context"
xsi:schemaLocation="
http:www.springframework.org/schema/beans http:www.springframework.org/schema/beans/spring-beans-2.5.xsd
http:www.springframework.org/schema/context http:www.springframework.org/schema/context/spring-context-2.5.xsd">
 
<beanid="viewResolver"
class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<propertyname="cache"value="true"/>
<propertyname="viewClass"
value="org.springframework.web.servlet.view.JstlView"/>
<propertyname="prefix"value="/WEB-INF/jsp/"/>
<propertyname="suffix"value=".jsp"/>
</bean>
<context:annotation-config/>
<bean
class="org.springframework.web.portlet.mvc.annotation.DefaultAnnotationHandlerMapping">
<propertyname="interceptors">
<bean
class="org.springframework.web.portlet.handler.ParameterMappingInterceptor"/>
</property>
</bean>
<beanid="MyJSRController"class="com.myjsr.MyJSRController">
</bean>
</beans>
 

jsrportlet.properties

nsAPI で使用される MyJSRerver の URL。

（注） クラスタ環境でポートレットが Service Portal アプリケーション URL を参照する場合は、URL を「http://localhost:<port>/RequestCenter」として指定します（<port> はクラスタの各ノードで使用するポート番号）。つまり、URL は「http:<host_name>/RequestCenter」として指定しないでください（<host_name> は Web サーバまたはクラスタのいずれかのホストのコンピュータ名）。

#(Port number and host has to changed as per the application server).
BASE_URL=http:localhost:8088/RequestCenter
 

Log4j.properties

log4j.rootCategory=INFO,CONSOLE
 
log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
log4j.appender.CONSOLE.layout.ConversionPattern=%d{ABSOLUTE}%-5p[%c{1}:%L]%m%n
 

JSR ポートレット コントローラのコンパイル

ポートレット コントローラをコンパイルするときは、次のライブラリを classpath に含めます。

1. newscale_compbeans.jar
2. newscale_conf.jar
3. newscale_core.jar
4. newscale_appclient.jar
5. pluto-container-2.0.2.jar
6. pluto-portal-driver-2.0.2.jar
7. pluto-portal-driver-impl-2.0.2.jar
8. pluto-container-api-2.0.2.jar
9. pluto-container-driver-api-2.0.2.jar
10. pluto-taglib-2.0.2.jar
11. org.springframework.aop-3.0.2.RELEASE.jar  
12. org.springframework.asm-3.0.2.RELEASE.jar               
13. org.springframework.aspects-3.0.2.RELEASE.jar           
14. org.springframework.beans-3.0.2.RELEASE.jar             
15. org.springframework.context-3.0.2.RELEASE.jar           
16. org.springframework.context.support-3.0.2.RELEASE.jar         
17. org.springframework.core-3.0.2.RELEASE.jar              
18. org.springframework.expression-3.0.2.RELEASE.jar                
19. org.springframework.instrument-3.0.2.RELEASE.jar                
20. org.springframework.instrument.tomcat-3.0.2.RELEASE.jar         
21. org.springframework.jdbc-3.0.2.RELEASE.jar     
22. org.springframework.jms-3.0.2.RELEASE.jar               
23. org.springframework.orm-3.0.2.RELEASE.jar               
24. org.springframework.oxm-3.0.2.RELEASE.jar               
25. org.springframework.spring-library-3.0.2.RELEASE.libd           
26. org.springframework.test-3.0.2.RELEASE.jar              
27. org.springframework.transaction-3.0.2.RELEASE.jar               
28. org.springframework.web-3.0.2.RELEASE.jar               
29. org.springframework.web.portlet-3.0.2.RELEASE.jar               
30. org.springframework.web.servlet-3.0.2.RELEASE.jar               
31. org.springframework.web.struts-3.0.2.RELEASE.jar   
32. commons-collections-3.2.1.jar
33. commons-lang-2.4.jar
34. j2ee.jar
35. json-lib-2.2.2-jdk13.jar
36. portlet-api_2.0_spec-1.0.jar
 

ポートレットの導入

導入手順は、使用するアプリケーション サーバによって異なります。全体的な注意点として、JSR ポートレットは、アプリケーション サーバの管理コンソールから一般的な Web アプリケーションと同様に導入できます。

JSR ポートレットを導入する方法、および導入後にポータル ページでポートレットを使用する方法の詳細については、『 Cisco Service Portal Designer Guide 』を参照してください。

このドキュメントは役に立ちましたか?

Feedbackフィードバック

シスコに問い合わせ