L'avventura dell'interprete UI - Un'indagine Java di Lotus Holmes

L'avventura dell'interprete UI Un'indagine Java di Lotus Holmes Autore: Fabrizio Marchesano Professione: Domino Developer

domino point day2009 In questo numero del Notes Mystery Magazine: • Il solito sospetto, ovvero chi sono • L'arte dell'investigazione per sviluppatori: una funzionalità non documentata in IBM Lotus Notes 8.5 • Un anno e 0.0.1 versioni dopo... • Da detective in poltrona a detective sul campo • L'ora della demo • «Porgetemi il violino...» • L'ora della demo (ripresa) • Conclusioni 2

domino point day2009 Chi sono: • Fabrizio Marchesano • Dipendente e socio della Frame Srl, Genova • Puro sviluppatore Domino • Specializzato in architettura Intranet • Desktop Office Integration Engineer • Mobile Solutions Architect • ...e appassionato di letteratura gialla classica (da Conan Doyle al Lotus Magazine) • http://www.frameweb.it/ 3

domino point day2009 Uno studio in Notes: • D: «Qual é la sfida più entusiasmante per un programmatore detective?» • R: «Una nuova, promettente e lungamente attesa funzionalità non documentata» • L'assenza di classi UI è sempre stata considerata dagli sviluppatori il tallone di Achille di Java in Notes... • ...perciò la scoperta di un package denominato com.ibm.notes.java.ui incluso nei file di installazione di Notes 8.5 è stata una gradita sorpresa 4

domino point day2009 Gli Irregolari di Eclipse Street: • Ma come aggirare la mancanza di documentazione ufficiale? • Elementi! Elementi! Elementi! Non possiamo fabbricare mattoni senza la creta! • Gli strumenti di lavoro di Mr. Lotus Holmes: Eclipse 3.4.2, Lotus Expeditor Toolkit 6.2 • Il primo passo: importazione del package com.ibm.notes.java.ui in un workspace di Eclipse e analisi della libreria referenziata notesui.jar 5

domino point day2009 User Friendly? No, Developer Friendly: • La nuova architettura introdotta con la versione 8 di Lotus Notes rendeva di fatto già possibile l'accesso alle informazioni sull'attività di front-end dell'utente via plug-in (vedi “Leveraging user context in the IBM Lotus Notes V8 sidebar and toolbar”, http://www.ibm.com/developerworks/lotus/library/notes8-context/ )... • ...ma era necessario utilizzare API di selezione proprie dell'ambiente Eclipse realizzando codice “ad hoc”, mentre le nuove classi rendono gli obiettivi più comuni relativi alle attività di front-end molto più immediati da raggiungere (ad esempio, interagire con i documenti selezionati in una vista) e sono molto più amichevoli da utilizzare per sviluppatori di estrazione LotusScript : Usare con cautela 6

domino point day2009 Lo strano comportamento di Mr. Lotus Holmes: • Un momento! • Perché quella minacciosa indicazione “Usare con cautela” riferita al metodo getSelectedDocuments() della classe NotesUIView? • Mr. Lotus Holmes non sa resistere a un tocco di teatralità; la risposta a questa domanda è contenuta nella soluzione del seguente problema matematico: Non documentato != Non utilizzabile Non documentato = Non supportato 7

domino point day2009 8.5.1 – 8.5.0 = ∞ • È un fatto: funzionalità non documentate possono essere modificate (o del tutto rimosse) senza alcun preavviso a utenti e sviluppatori • Inoltre, è ormai consolidato che la versione 8.5.1 di Lotus Notes è ben lungi dall'essere una piccola release incrementale • Perché quindi dovremmo sorprenderci nel constatare che la struttura del package com.ibm.notes.java.ui è stata completamente rinnovata? • E quando Mr. Lotus Holmes dice “completamente”... 8

domino point day2009 ... intende completamente: • Non indagheremo i motivi: le relazioni tra causa ed effetto non sono mai così semplici da analizzare come nella famosa barzelletta del camping interpretata da Sherlock Holmes e il Dottor Watson 9

domino point day2009 Punti di vista: • Sono state inserite funzionalità addizionali (che sono sempre benvenute), alcune classi appartengono ora a package differenti e alcuni metodi sono stati rinominati o semplicemente non esistono più • Ad esempio, le classi UI relative a documenti e viste sono ora “figlie” di package dedicati: • E tutti i metodi relativi alla selezione di documenti della classe NotesUIView, compreso l'originale getSelectedDocuments(), sono stati rimossi: 10

domino point day2009 Ma tutto (o quasi) è ora ufficialmente documentato: 11

domino point day2009 Manuale pratico della coltura dei plug-in: • L'equipaggiamento definitivo di Mr. Lotus Holmes: IBM Lotus Notes 8.5.1 (comprensivo di Symphony Productivity Tools), IBM Lotus Expeditor 6.2.1, Eclipse 3.4.2 • Per la configurazione necessaria, fare riferimento al seguente articolo: http://www-10.lotus.com/ldd/lewiki.nsf/dx/ Using_IBM_Lotus_Expeditor_Toolkit_6.2.1_with_IBM_Lotus_Notes_8.5.1 • Poiché in seguito avremo occasione di interagire con documenti di testo e fogli di calcolo tramite Symphony, utilizzeremo uno scorciatoia importando nel nostro ambiente Eclipse il plug-in Hello World incluso nel Symphony Developer Toolkit disponibile al seguente indirizzo: http://symphony.lotus.com/software/lotus/symphony/developers.nsf/home • Il risultato nella Notes sidebar sarà il seguente: 12

domino point day2009 Il pulsante dell'ingegnere: • Per iniziare a mettere in pratica le nostre congetture, tutto ciò di cui abbiamo bisogno è un pulsante in attesa di essere premuto • Sostituiamo all'originale ShelfView.java il seguente codice: import org.eclipse.swt.SWT; import org.eclipse.swt.widgets.Composite; import org.eclipse.ui.part.ViewPart; import org.eclipse.swt.layout.RowLayout; import org.eclipse.swt.widgets.Button; import org.eclipse.swt.events.SelectionAdapter; import org.eclipse.swt.events.SelectionEvent; import org.eclipse.jface.dialogs.MessageDialog; public class ShelfView extends ViewPart { public void createPartControl(Composite parent) { parent.setLayout(new RowLayout()); Button getButton = new Button(parent,SWT.NONE); getButton.setText("Detect!"); getButton.addSelectionListener(new SelectionAdapter(){ public void widgetSelected(SelectionEvent arg0){ // here we will put our code }}); } public void setFocus() { }} • Un cambio di icona e di titolo completeranno la trasformazione: 13

domino point day2009 La configurazione finale: • Al fine di utilizzare i lungamente desiderati oggetti UI, è necessario aggiungere il package com.ibm.notes.java.ui alla lista dei Required Plug-ins nella sezione relativa alle Dependencies: • A questo punto siamo pronti per importare nel nostro codice le classi occorrenti: import com.ibm.notes.java.ui.*; import com.ibm.notes.java.ui.documents.*; import com.ibm.notes.java.ui.views.*; 14

domino point day2009 Senza indizio... oppure no? • Mr. Lotus Holmes ritiene che le concrete e più comuni esigenze siano un ottimo punto di partenza per lo studio pratico di nuove funzionalità • Un primo obiettivo potrebbe ad esempio essere quello di modificare il valore di un campo sui documenti selezionati in una vista • Ma, come abbiamo visto, il metodo getSelectedDocuments() è stato rimosso dalla classe NotesUIView e non sono indicate alternative nella documentazione • In casi come questo, l'aiuto degli Irregolari di Eclipse Street risulta ancora una volta inestimabile: 15

domino point day2009 «Se si servirà del codice che le ho spiegato...» • Per ottenere un'istanza a un oggetto di tipo NotesUIViewAdapter, dobbiamo trasformare l'oggetto NotesUIView nel suo corrispondente adapter • Aggiungiamo le seguenti righe di import: import org.eclipse.core.runtime.IAdaptable; import org.eclipse.core.runtime.IAdapterManager; import org.eclipse.core.runtime.Platform; • E utilizziamo il seguente codice per eseguire la trasformazione da un oggetto a un altro (fonte: http://www.ibm.com/developerworks/lotus/library/notes8-context/) public static Object getAdapterObject(Object o, Class clazz) { Object item = null; if(clazz.isInstance(o)) item = o; else if(o instanceof IAdaptable) { item = ((IAdaptable)o).getAdapter(clazz); } if(item==null) { IAdapterManager man = Platform. getAdapterManager (); if(man!=null) item = man.getAdapter(o, clazz); } return item; } 16

domino point day2009 Vedere attraverso il travestimento: • Le radicate abitudini LotusScript porterebbero a far pensare che il metodo getSelectedDocuments() restituisca una NotesDocumentCollection... • ...ma quello che otteniamo è in realtà un vettore di stringhe: • ... che siamo però in grado di gestire in quanto ogni elemento altro non è che il Notes URL corrispondente a ciascun documento, che possiamo analizzare con un parser per recuperare tutte le informazioni necessarie (nome server, database replica ID e Unique ID di vista e documento) o utilizzare direttamente come parametro per il metodo resolve della classe NotesSession (che ci restituirà un oggetto di tipo NotesDocument) 17

domino point day2009 E con tutti i dati che abbiamo in mano... • Codice di esempio: preparativi per la gestione delle care vecchie classi di back-end import lotus.domino.*; • Codice di esempio: ottenere un'istanza al primo dei documenti selezionati NotesUIWorkspace w = new NotesUIWorkspace(); NotesUIView uv=w.getCurrentView(); NotesUIViewAdapter va=(NotesUIViewAdapter) getAdapterObject(uv, NotesUIViewAdapter. class); try { NotesThread.sinitThread(); Session s=NotesFactory. createSession(); Document doc=(Document) s.resolve(va.getSelectedDocuments()[0]); // put here your code to manage the 'doc' object NotesThread.stermThread(); } catch (NotesException e) { e.printStackTrace(); } 18

domino point day2009 L'ora della demo: • Demo 1: modificare il valore di un campo sui documenti selezionati doc.replaceItemValue(fieldName, fieldValue); • Demo 2: esportare dati dai documenti selezionati in foglio di calcolo Symphony RichDocumentView rdView = RichDocumentViewFactory. openView (RichDocumentType. SPREADSHEET_TYPE); Object model = rdView.getUNOModel(); XModel xModel=(XModel) UnoRuntime. queryInterface(XModel.class, model); XController xSpreadsheetController = xModel.getCurrentController(); XSpreadsheetView xSpreadsheetView = (XSpreadsheetView)UnoRuntime. queryInterface( XSpreadsheetView. class, xSpreadsheetController); XSpreadsheet xSheet=xSpreadsheetView.getActiveSheet(); ... XCell xCell = xSheet.getCellByPosition(column,row); xCell.setFormula(doc.getItemValue(fieldName)); ... • E adesso tocca voi: utilizzate gli estratti di codice disponibili qui sopra e buona personalizzazione 19

domino point day2009 Un problema da tre buone pipate: • Siamo ora in grado di interagire con la vista attiva; e per quanto riguarda il secondo obiettivo più comune per le attività di front-end, ossia recuperare o scrivere informazioni con riferimento al documento a video? • Vediamo cosa hanno da dire gli ormai fidati Irregolari di Eclipse Street in merito alle classi NotesUIWorkspace, NotesUIDocument e NotesUIField: 20

domino point day2009 Un'altra oncia di tabacco, prego: • Per ottenere il valore di un campo da un documento attivo avremo quindi bisogno di alcune righe di codice come le seguenti: NotesUIWorkspace w = new NotesUIWorkspace(); NotesUIDocument uiDoc=w.getCurrentDocument(); String myValue=uiDoc.getField(fieldName).getText(); • Ma se volessimo recuperare il contenuto di campi nascosti? Il metodo getField() della classe NotesUIDocument non è adatto a questo scopo e dobbiamo attivare un'istanza al corrispondente documento di back-end tramite l'apposita classe NotesBEDocument: • E modificando il nostro punto di vista: NotesBEDocument Doc=uiDoc.getBEDocument(); String myValue=Doc.getItemString(fieldName); 21

domino point day2009 L'ora della demo (ripresa): • Demo 3: esportare dati da un documento Notes a un documento Symphony RichDocumentView rdView = RichDocumentViewFactory. openView( ODTPath, false ); Object obj = rdView.getUNOModel(); XModel model = ( XModel )UnoRuntime. queryInterface( XModel.class, obj ); XTextDocument xdoc = ( XTextDocument ) UnoRuntime. queryInterface (XTextDocument.class, model); // getting bookmarks collection XBookmarksSupplier xBookmarksSupplier = (XBookmarksSupplier)UnoRuntime. queryInterface (XBookmarksSupplier. class, xdoc); XNameAccess xNamedBookmarks = xBookmarksSupplier.getBookmarks(); Object foundBookmark = null; try { // retrieve bookmark by name foundBookmark = xNamedBookmarks.getByName(bookmarkName); // setting text XTextContent xFoundBookmark = (XTextContent)UnoRuntime. queryInterface (XTextContent.class, foundBookmark); XTextRange xFound = xFoundBookmark.getAnchor(); xFound.setString(myValue); } catch (NoSuchElementException e) { e.printStackTrace(); } catch (WrappedTargetException e) { e.printStackTrace(); } • E ora a voi: preparate un template OTT con Symphony e buona direzione 22

domino point day2009 L'avventura del pinguino dagli occhi gialli: • E ora la parte migliore: a meno di specifiche necessità, i vostri plug-in saranno platform-independent, non solo dal punto di vista dell'utente ma anche da quello dello sviluppatore • In altre parole, potrete iniziare a creare codice su sistema operativo Windows, esportare il tutto e terminare la compilazione su Linux e distribuire infine il vostro lavoro a utenti Windows e Linux • «E adesso a voi, caro Mac...» 23

domino point day2009 Conclusioni: • La nuove classi Java UI possiedono uno straordinario potenziale per gli sviluppatori Notes (e conseguentemente per gli utenti) • Anche solo limitandoci alle classi, oggetti, proprietà e metodi illustrati in questa presentazione, pensate alle infinite possibilità per la creazione di plug-in dedicati a tutte quelle sempreverdi necessità di front-end che attualmente impongono la duplicazione di codice in ciascun target database • E la possibilità di interagire con Symphony è decisamente allettante, non trovate? • Il futuro deciderà in merito ad altre aree di intervento; il nostro obiettivo era al momento quello di svelare le potenzialità del package com.ibm.notes.java.ui e confidiamo di essere riusciti nell'intento • Buon lavoro a tutti! 24

domino point day2009 Alcune utili informazioni: • Gli elementi caratteristici di Sherlock Holmes, come il cappello deerstalker, la pipa calabash e la famosa esclamazione «Elementare, Watson!», non sono mai menzionati nelle storie originali scritte da Sir Arthur Conan Doyle • “L'interprete greco” è il racconto in cui appare per la prima volta il fratello maggiore di Sherlock, Mycroft Holmes; ma c'è davvero bisogno di Mycro..ft? • Non chiedete “yellow books” in libreria all'estero: la definizione di “giallo” inteso come “detective story” è tutta italiana e deriva dal colore della copertina della più longeva e famosa serie tematica • E ora siete pronti per l'ultima slide? 25

domino point day2009 Sfida al lettore: • In questa presentazione sono presenti numerosi riferimenti e citazioni Sherlockiane (sia letterali che adattate) • La fonte è sempre il canone originale di 4 romanzi e 56 racconti di Sir Arthur Conan Doyle (con una sola eccezione) • Riuscirete a trovarle tutte? • E cosa significa l'immagine seguente? • Risolvete il mistero (chiedete aiuto a Holmes, se necessario) e inviatemi un plug- in, naturalmente utilizzando le nuove classi Java UI, con la soluzione all'indirizzo: fabrizio.marchesano@frameweb.it 26

domino point day2009 Q&A: • Per approfondimenti, venite a trovarmi al numero 221B di Eclipse Street... • ...o fate semplicemente ora le vostre domande • E se state pensando che la slide precedente, che avevo definito “ultima”, non lo era veramente poiché state leggendo questa, vi risponderò dicendovi che anche la cosiddetta “ultima avventura” di Sherlock Holmes non era davvero l'ultima, perciò tutto torna • Grazie per l'attenzione • Per contatti: fabrizio.marchesano@frameweb.it 27

domino point day2009 Platinum Sponsor Gold Sponsor

L'avventura dell'interprete UI - Un'indagine Java di Lotus Holmes

by Dominopoint - Italian Lotus User Group

Accessibility

Categories

Upload Details

Usage Rights

2 Embeds 69

Statistics

L’avventura dell’interprete UI - Un’indagine Java di Lotus Holmes Presentation Transcript

http://www.dominopoint.it	65
http://www.slideshare.net	4