COMP 110/401 APPENDIX: INSTALLING AND USING ECLIPSE. Instructor: Prasun Dewan (FB 150,

Transcription

1 COMP 110/401 APPENDIX: INSTALLING AND USING ECLIPSE Instructor: Prasun Dewan (FB 150,

2 SCOPE: BASICS AND BEYOND Basic use: CS 1 Beyond basic use: CS2 2

3 DOWNLOAD FROM Get the latest IDE for Java Developers, not Indigo 3

4 EXTRACT ALL 4

5 SELECT DESTINATION FOLDER 5

6 CREATE SOME KIND OF SHORTCUT FOR ECLIPSE.EXE 6

7 RUN ECLIPSE.EXE 7

8 SPECIFY PROJECTS DIRECTORY 8

9 REMOVE WELCOME TAB IF IT APPEARS 9

10 ADD A NEW JAVA PROJECT 10

11 ENTER PROJECT NAME 11

12 SWITCH TO JAVA PERSPECTIVE (MAY GET THIS MESSAGE) 12

13 EMPTY PROJECT CREATED 13

14 ADD A PACKAGE TO SELECTED PROJECT Select project and File Package 14

15 ENTER PACKAGE NAME 15

16 EMPTY PACKAGE IN NON EMPTY PROJECT 16

17 ADD A CLASS Select project and File Class 17

18 NAME THE CLASS 18

19 EMPTY CLASS IN NON EMPTY PACKAGE 19

20 EDIT THE FILE (COPY AND PASTE CODE) package warmup; import java.io.bufferedreader; import java.io.inputstreamreader; public class AGreeter { static BufferedReader inputstream = new BufferedReader(new InputStreamReader(System.in)); public static void main(string[] args) { System.out.println("Hello World"); if (args.length > 0) { System.out.println(args[0]); } try { System.out.println (inputstream.readline()); } catch (Exception e) { System.out.println("Could not read line"); e.printstacktrace(); } } } Copy and paste code from: 20

21 SAVE (AND COMPILE) THE FILE File Save or CTRL+S 21

22 WORKSPACE, PROJECT, SOURCE PACKAGE FOLDER Workspace Project Source Package Class Source 22

23 WORKSPACE, PROJECT, BINARY PACKAGE FOLDER Workspace Project Binary Package Class Object (Binary) Code 23

24 EXECUTE THE MAIN METHOD ON SELECTED CLASS Right Menu Debug As Java Application Can also select Run but Debug is more defensive 24

25 FIND OR SWITCH WORKSPACE FOLDER: FILE SWITCH WORKSPACE 25

26 FIND PROJECT FOLDER: SELECT PROJECT, RIGHTCLICK PROPERTIES RESOURCE 26

27 VIEW OUTPUT IN CONSOLE WINDOW 27

28 PROVIDE INPUT IN CONSOLE WINDOW 28

29 THE OUTPUT AFTER ENTER 29

30 SUPPLY USER ARGUMENT: Right Menu Debug As Debug Configuration 30

31 SELECT MAIN CLASS IN CONFIGURATION 31

32 SPECIFY AND APPLY ARGUMENT IN ARGUMENT TAB AND PRESS DEBUG Argument must be in quotes. Args[0] = Ca Va Without quotes Java will make each word a separate argument (args[0] = Ca, args[1] = Va 32

33 EXECUTE WITH SUPPLIED ARG 33

34 ARG PRINTED, PROGRAM, STILL RUNNING, WAITING FOR INPUT Button available in both Debug and Java Perspective, only of them is active 34

35 TERMINATED PROGRAM 35

36 DEBUG LAST MAIN LAUNCHED: F11 No need to select a main class 36

37 CLOSING A WINDOW PERHAPS ACCIDENTALLY 37

38 VANISHED CONSOLE 38

39 WINDOW RESET PERSPECTIVE 39

40 WINDOW SHOW VIEW Can selectively remove and add sub-windows/views 40

41 TARGET Basic use Beyond basic use (ignore for 401) 41

42 CREATE A PROJECT FROM EXISTING CODE Source Code of Class Examples Zipped Directory JavaToHTML Click on Zipper Directory Link in SlideShow Mode Unzip the zipped directory Make a Java project out of it by following the steps described 42

43 CREATE A PROJECT OUT OF EXISTING CODE: FILE NEW JAVA PROJECT 43

44 UNCHECK DEFAULT LOCATION BOX 44

45 ENTER LOCATION AND NAME 45

46 NEW PROJECT CREATED But it will have errors because of missing ObjectEditor library 46

47 LIBRARY LOCATION ON THE WEB Downloads Click on the latest version (on my web page, not this page) to download the jar (same as zip) and do not unzip/unjar it 47

48 DOWNLOAD LIBRARY TO LOCAL COMPUTER Do not unzip/unjar it 48

49 SELECT PROJECT, AND PROJECT PROPERTIES Must do this for each project! 49

50 SELECT BUILD PATH, ADD EXTERNAL JAR 50

51 SELECT SAVED JAR 51

52 SELECT BUILD PATH, PROJECTS 52

53 REMOVE SPURIOUS PROJECTS 53

54 PRESS OK TO COMMIT 54

55 CHANGE THE JAVA VERSION (IF NECESSARY): WINDOW PREFERENCES 55

56 JAVA COMPILER PREFERENCES 56

57 REBUILD OR RECOMPILE ALL CLASSES 57

58 EXECUTING CODE GIVES JAVA, JAVAC INCOMPATIBILITY ERROR 58

59 CHANGE THE JAVA VERSION: WINDOW PREFERENCES 59

60 PRESS SEARCH BROWSE BUTTON 60

61 PRESS SEARCH BROWSE BUTTON TO INSTALLED JDK (SEE APPENDIX ON INSTALLATION) 61

62 JRE ADDED TO ECLIPSE, SELECT IT AND CAN EXECUTE WITHOUT ERRORS 62

63 SOME EXPLICIT INSTRUCTIONS FOR MAC You can get that for mac here: The problem is Eclipse won't change the compiler to use 1.7 so you will have to specify that under: Eclipse -> Preferences -> Java -> Installed JREs Click "Add..." then choose "MacOS X VM" Next, then under directory copy/paste this: /Library/Java/JavaVirtualMachines/jdk1.7.0_40.jdk/Contents/Home Make sure it recognizes this as Java SE 7. Then name doesn't really matter. Now go to: Eclipse -> Preferences -> Java -> Compiler Change the compliance level to: "1.7" Now it probably still won't work (at least it didn't on mine) This is because your project is still set on 1.6 So, go to: Project -> Properties -> Java Build Path -> Libraries Add Library... JRE System Library "Workspace default" should be automatically there as the 1.7, but if not find the 1.7 library. Then remove the 1.6 library Also you need to change the compiler being used by the project: Project -> Properties -> Java Compiler and make sure everything is on 1.7 Now, if you're getting an error about the main class not being found or working. You may just want to create a new project and when you select the 1.7 JRE. 63

64 DELETING A PROJECT Right click project and delete. Usually not a good idea to delete project on disk, can always use the OS to do so, which will put it in the recycling bin 64

65 COPY TYPES (CLASSES, INTERFACES, ENUMS) FROM PACKAGE TO ANOTHER: COPY Select type(s) in source project and package and press CTRL-C (or File Copy right menu item) 65

66 COPY TYPES FROM ONE PACKAGE TO ANOTHER: PASTE Select package in destination project and package and press CTRL-V (or File Paste right menu item) 66

67 COPYING CLASSES FROM ONE PACKAGE TO ANOTHER: NEW CLASS IN NEW PACKAGE AND PROJECT Repackaged type added (and its imports are changed to other copied types if multiple types are copied and pasted together) 67

68 JUMPING TO IDENTIFIER DEFINITION AND NAVIGATION STACK ALT + Forward Arrow goes forwards in the navigation stack a la browser forward button ALT + Back Arrow takes you back where you came from, a la Browser back button, can execute multiple times to back in in the stack of visited points F3 when cursor is a start of an identifier Makes Eclipse take you to the definition of the identifier in an edit window 68

69 FIND THE USES CTRL-SHIFT-G when cursor is a start of an identifier Double clicking a method reference Makes Eclipse show the methods that reference the identifier in the search tab Makes Eclipse show the method and highlight all references of the identifier 69

70 MULTI FILE TEXT SEARCH FOR PRINTLN 70

71 SEARCH RESULTS Use CTR+SHIFT+G (shown earlier) to find active uses of the method 71

72 MENU REFACTOR RENAME IDENTIFIER: ALT + SHIFT + R Select type, right menu Refactor Rename All references will be updated! 72

73 COMPLETE IDENTIFIER: CTRL + SPACE AFTER PREFIX public static final long NUMBER_OF_LARGE_FACTORIAL_COMPUTATIONS = ; Give file name 73

74 UNDERSTAND AND CORRECT ERRORS 74

75 CORRECT ALL IMPORT ERRORS IN FILE: CTRL + SHIFT + O In Eclipse press CTRL-SHIFT-O to automatically import all used types that need to be imported but have not been imported If class is in more than one package, Eclipse gives a choice All unused imports are also removed Can select multiple types or a project to refresh all imports in the selected types/project 75

76 SET A BREAK POINT OR TEL ECLIPSE TO STOP WHEN IT REACHED SOME LINE Double clicking again will remove dot and break point Can also use right menu in side bar to enable and disable break point 76

77 DEBUG PROGRAM AND ENTER INPUT 77

78 MAY GET THIS MESSAGE BEFORE BREAK POINT HIT 78

79 DEBUG PERSPECTIVE AND STOPPING AT BREAKPOINT 79

80 RUN STEP OVER TO NEXT STATEMENT (F6) 80

81 STOPPED AT NEXT STATEMENT Local variable 81

82 RUN STEP INTO SETNUMBER (F5) Call stack Called method parameters 82

83 RUN STEP RETURN OR F7 Call stack 83

84 STEP OVER AND THEN STEP INTO GETFACTORIAL Elided (Collapsed) Instance Vars 84

85 EXAMINE VARIABLES Expanded Instance Vars 85

86 STEP INTO RECURSINGFACTORIAL 86

87 STEP OVER IF 87

88 STEP INTO RECURSIVE CALL 88

89 EXAMINE PARENT CALL 89

90 STEP OVER IF 90

91 STEP INTO YET ANOTHER RECURSIVE CALL 91

92 RUN RESUME TO NEXT BREAK POINT OR USER INPUT (NO MORE SINGLE STEPPING) 92

93 ENTER NEGATIVE NUMBER TO TERMINATE 93

94 STOPPING AGAIN AT BREAKPOINT 94

95 TERMINATED IN DEBUG PERSPECTIVE 95

96 RETURN TO JAVA PERSPECTIVE 96

97 JUNIT: NEW CLASS WITHOUT MAIN 97

98 JUNIT: INSTALL JUNIT 98

99 JUNIT ADDED AND IMPORTED 99

100 RUN JUNIT 10 0

101 JUNIT RESULT 10 1

102 RETURNING TO JAVA PERSPECTIVE 10 2

103 10 3

104 10 4 FINDING THE DEFINITION CTRL + SHIFT + G before a identifier

105 10 5 FINDING THE DEFINITION F3 before a use

106 10 6 EXAMINING MAIN PARAMETERS Main Parameters

107 NEW OUTPUT AND LOCAL VARIABLE Index gets initialized println() 10 7

108 STEP OVER 10 8

109 STEP INTO NEXT LINE (SAME AS STEP OVER) 10 9

110 TERMINATING RUNNING PROGRAM 11 0

111 11 1 STEP INTO SETNUMBER (RUN STEP INTO OR F5) Call stack Called method parameters

112 11 2 STEP RETURN STEP RETURN OR F7 Call stack

113 11 3 STEP OVER AND THEN STREP INTO GETFACTORIAL Elided (Collapsed) Instance Vars

114 11 4 EXAMINING VARIABLES Expanded Instance Vars

115 STEP INTO RECURSINGFACTORIAL 11 5

116 STEP OVER IF 11 6

117 STEP INTO RECURSIVE CALL 11 7

118 EXAMINING PARENT CALL 11 8

119 STEP OVER 11 9

120 STEP INTO YET ANOTHER RECURSIVE CALL 12 0

121 RESUME TO NEXT BREAK POINT OR USER INPUT (NO MORE SINGLE STEPPING) 12 1

122 ENTER NEGATIVE NUMBER TO TERMINATE 12 2

123 STOPPING AGAIN AT BREAKPOINT 12 3

124 TERMINATED 12 4

125 RETURNING TO JAVA PERSPECTIVE 12 5

126 TWO OTHER USEFUL BUT COMPLICATED REFACTOR OPTIONS Change method signature Will try to update references to match the signature, which can be erroneous Extract interface of class C Will create interface of selected public methods and will make the interface the type of all variables declared to be of class type Adds potentially unwanted comments to method headers and sometimes updates to references have not worked in the past for me Maybe better to get all references and update them individually for both purposes 12 6