Component-Based Development

Transcription

1 Component-Based Development Marco Scotto

2 Outline Views Introduction View Declaration View Model Content Provider Label Provider 2

3 Introduction (1/5) Many plug-ins either add a new Eclipse view or enhance an existing Eclipse view as a way to provide information to the user 3

4 Introduction (2/5) Views must implement the org.eclipse.ui.iviewpart interface. Typically views are subclasses of org.eclipse.ui.part.viewpart and thus indirectly subclasses of org.eclipse.ui.part.workbenchpart, inheriting much of the behavior needed to implement the IViewPart interface 4

5 Introduction (3/5) 5

6 Introduction (4/5) Views are contained in a view site, (an instance of org.eclipse.ui.iviewsite), which in turn are contained in a workbench page (an instance of org.eclipse.ui.iworkbenchpage). In the spirit of lazy initialization, the IWorkbenchPage holds on to instances of org.eclipse.ui.iviewreference rather than the view itself so that views can be enumerated and referenced without actually loading the plug-in defining the view. 6

7 Introduction (5/5) Because there are potentially 100 s of views in the workbench, views are organized into categories. The Show View dialog presents a list of views organized by category so that the user can more easily find the desired view. 7

8 View Declaration There are three parts involved in creating a new view: Define the view category in the plug-in manifest file Define the view in the plug-in manifest file Create the view part containing the code 8

9 Declaring a View Category (1/4) First, to define the new view category, edit the plug-in manifest and navigate to the Extensions page Click the Add button to add the org.eclipse.ui.views extension if it is not already present 9

10 Declaring a View Category (2/4) The Main View Settings dialog is used modify the attributes of the view For the category containing the Tasks view, the attributes would be as follows: Java Package Name it.unibz.plugins.tasks.views the package of the view class View Class Name TasksView the name of the class defining the view and implementing the org.eclipse.ui.iviewpart interface. The class is instantiated using its no argument constructor, but may be parameterized using the IExecutableExtension interface. name Tasks View the human readable name for the view displayed in the view s title bar and in the Show View dialog View Category Id it.unibz.plugins the unique identifier for the category View Category Name UniBZ plugins the human readable name for the category that appears in the Show View dialog 10

11 Declaring a View Category (3/4) 11

12 Declaring a View Category (4/4) Click on Next Unselect all checkboxes Click on Finish 12

13 ViewPart The code defining the view s behavior is found in a class implementing the org.eclipse.ui.iviewpart interface, typically by subclassing the org.eclipse.ui.part.viewpart abstract class 13

14 View Methods (1/2) createpartcontrol(composite) required. Create the controls comprising the view. Typically this method simply calls more finely grained methods such as createtable, createsortactions, createfilters, etc. dispose() Cleanup any platform resources, such as images, clipboard, etc, that were created by this class. This follows the if you create it you destroy i theme that runs throughout Eclipse 14

15 View Methods (2/2) getadapter(class) Returns the adapter associated with the specified interface so that the view can participate in various workbench actions. Adapters returned by views include IShowInSource, IShowInTarget, and IContributedContentsView among others savestate(imemento) - Save the local state of this view, such as the current selection, current sorting, current filter, etc. setfocus() required. Set focus to the appropriate control within the view 15

16 View Controls (1/4) Views can contain any type and number of controls, but typically a view such as the Tasks view contains a single table or tree control 16

17 View Controls (2/4) The Tasks view could use the SWT table widget directly, but the higher level JFace table viewer wraps the SWT table widget and is easier to use It handles much of the underlying grunt work, allowing us to add, select, and remove our model objects directly rather than dealing with the underlying instances of TableItem 17

18 View Controls (3/4) With this in mind, we start by enhancing the createpartcontrol( ) method Table table = new Table(parent, SWT.SINGLE SWT.H_SCROLL SWT.V_SCROLL SWT.FULL_SELECTION); table.setheadervisible(true); table.setlinesvisible(true); TableColumn column = new TableColumn(table, SWT.NONE, 0); column.settext("completed"); column.setwidth(50); column.setalignment(swt.left); column = new TableColumn(table, SWT.NONE, 1); column.settext("description"); column.setwidth(100); column.setalignment(swt.left); column = new TableColumn(table, SWT.NONE, 2); column.settext("owner"); column.setwidth(100); column.setalignment(swt.left); 18

19 View Controls (4/4) column = new TableColumn(table, SWT.NONE, 3); column.settext("percentage"); column.setwidth(50); column.setalignment(swt.left); viewer = new TableViewer(table); viewer.setcontentprovider(new TaskViewContentProvider()); viewer.setlabelprovider(new TaskViewLabelProvider()); viewer.setinput(taskmanager.getmanager()); 19

20 View Model A view may have its own internal model such as the our view, or use existing model objects such as an IResource and its subtypes, or not have any model at all In our case, we create: Task a class that represents our business objects TaskManager holds task objects 20

21 Task class (1/2) package it.unibz.plugins.tasks.model; public class Task { private boolean completed = false; private String description = ""; private String owner = "?"; private int percentcomplete = 0; public Task(String string) { super(); setdescription(string); public boolean iscompleted() { return completed; public String getdescription() { return description; 21

22 Task class (2/2) public String getowner() { return owner; public int getpercentcomplete() { return percentcomplete; public void setcompleted(boolean b) { completed = b; public void setdescription(string string) { description = string; public void setowner(string string) { owner = string; public void setpercentcomplete(int i) { percentcomplete = i; 22

23 TaskManager class (1/3) package it.unibz.plugins.tasks.model; import java.util.*; public class TaskManager { private static TaskManager manager = null; private Collection tasks; private List listeners = new ArrayList(); private TaskManager() { public static TaskManager getmanager() { if (manager == null) manager = new TaskManager(); return manager; public Task[] gettasks() { if (tasks == null) loadtasks(); return (Task[]) tasks.toarray(new Task[tasks.size()]); 23

24 TaskManager class (2/3) public void addtask(task[] items) { Task[] removedtasks = new Task[] {; if (tasks == null) loadtasks(); if (tasks.addall(arrays.aslist(items))) firetaskchanged(items, removedtasks); public void removetask(task[] items) { Task[] addedtasks = new Task[] {; if (tasks == null) loadtasks(); if (tasks.removeall(arrays.aslist(items))) firetaskchanged(addedtasks, items); private void loadtasks() { tasks = new HashSet(5); Task t1 = new Task("Maintainance"); tasks.add(t1); Task t2 = new Task("Development"); t2.setowner("teama"); t2.setpercentcomplete(20); tasks.add(t2); 24

25 TaskManager class (3/3) /////// TaskManagerListener methods //////////// public void addtasksmanagerlistener( TaskManagerListener listener) { if (!listeners.contains(listener)) listeners.add(listener); public void removetaskmanagerlistener(taskmanagerlistener listener) { listeners.remove(listener); private void firetaskchanged(task[] itemsadded, Task[] itemsremoved) { TaskManagerEvent event = new TaskManagerEvent(this, itemsadded, itemsremoved); for (Iterator iter = listeners.iterator(); iter.hasnext();) ((TaskManagerListener) iter.next()).taskchanged(event); 25

26 TaskManagerEvent class package it.unibz.plugins.tasks.model; public class TaskManagerEvent { private Task[] added; private Task[] removed; private TaskManager manager; public TaskManagerEvent(TaskManager manager, Task[] added, Task[] removed) { this.manager = manager; this.added = added; this.removed = removed; public Task[] getitemsremoved() { return removed; public Task[] getitemsadded() { return added; 26

27 TaskManagerListener interface package it.unibz.plugins.tasks.model; public interface TaskManagerListener { /** event */ public void taskchanged(taskmanagerevent event); 27

28 Content Provider Once the model objects have been created, they need to be linked into the view A content provider is responsible for extracting objects from an input object, in this case the TaskManager, and handing them to the table viewer for displaying, one object in each row of the table Although the IStructuredContentProvider does not specify this, we will also make the content provider responsible for updating the viewer when the TasksManager s content changes 28

29 Content Provider Class (1/2) package it.unibz.plugins.tasks.views; import org.eclipse.jface.viewers.*; import it.unibz.plugins.tasks.model.*; class TaskViewContentProvider implements IStructuredContentProvider, TaskManagerListener { private TableViewer viewer; private TaskManager manager; public void inputchanged(viewer viewer, Object oldinput, Object newinput) { this.viewer = (TableViewer) viewer; if (manager!= null) manager.removetaskmanagerlistener(this); manager = (TaskManager) newinput; if (manager!= null) manager.addtasksmanagerlistener(this); 29

30 Content Provider Class (2/2) public void dispose() { public Object[] getelements(object parent) { return manager.gettasks(); public void taskchanged(taskmanagerevent event) { viewer.gettable().setredraw(false); try { viewer.remove(event.getitemsremoved()); viewer.add(event.getitemsadded()); finally { viewer.gettable().setredraw(true); 30

31 Label Provider The label provider takes a table row object returned by the content provider and extracts the value to be display in a column. After refactoring the FavoritesView.ViewLabelProvider inner class into a top-level class, and reworking it to extract values from the newly created model object, it looks something like the code shown below: 31

32 Label Provider Class (1/2) package it.unibz.plugins.tasks.views; import it.unibz.plugins.tasks.model.task; import org.eclipse.jface.viewers.*; import org.eclipse.swt.graphics.*; class TaskViewLabelProvider extends LabelProvider implements ITableLabelProvider { public String getcolumntext(object obj, int index) { Task t = (Task) obj; switch (index) { case 0 : // Completed column if (t.iscompleted()) return "yes"; else return "no"; 32

33 Label Provider Class (2/2) case 1 : // Description column return t.getdescription(); case 2 : // Location column return t.getowner(); case 3 : return new Integer(t.getPercentComplete()).toString(); default : return ""; public Image getcolumnimage(object obj, int index) { return null; 33