wiki:Ohj1Eclipse
Last modified 5 years ago Last modified on 2013-01-06 19:26:12

Eclipsen käyttö Ohjelmointi 1-kurssilla

Java ohjelmia voi toki kirjoittaa millä tahansa tekstieditorilla ja kääntää komentoriviltä. Hyvä integroitu kehitysympäristö (IDE) tekee kuitenkin ammattimaisesta työstä sujuvaa ja siirtää rutiinitöitä ohjelmoijalta ympäristölle.

Eclipse on yksi varsin käyttökelpoinen IDE Java-ohjelmointiin. Toki se on ominaisuuksiensa takia monimutkainen, mutta kun sitä opettelee käyttämään, saakin jo hyvän vaivanpalkan.

1. Alkuvalmisteluja

  • Mikroluokissa Eclipse on valmiiksi asennettuna ja voidaan hypätä seuraavien kohtien yli.
  • Hae ja asenna kotikoneeseen JDK
  • Hae ja asenna kotikoneeseen sopiva Eclipsen versio. Esimerkiksi JavaEE. Jos levytila on vähissä, riittäneen myös Eclipse IDE for Java Developers.
  • asentaminen tarkoittaa sitä, että purat hakemasi .zip -tidoston jonnekin, esimerkiksi c:\devel\ee35 -hakemistoon
  • siirry kerran siihen hakemistoon, johon purit, esim: c:\devel\ee35\eclipse ja ja sieltä komento Eclipse.exe ja tee pieni Java-ohjelma ja aja se.
  • Hae Java SE 6 Documentation jos sitä ei tullut Eclipsen mukana. Kelaa kohtaan Documentation ja lataa. Pura tiedosto samaan hakemistoon, johon asensit JDK 1.6:en.
    • Jos ei vielä toimi niin mene Eclipsessä haluamasi projektin alla Jre System Libraryn kohdalle (vaihda hakasulkeisiin uusin jdk, jos käytössä on jre, tämä tapahtuu Window-Preferences-Java-Installed JREs), valitse rt.jar-Properties-Javadoc location ja aseta file:/C:/Program Files/Java/jdk1.6.0_05/docs/api -tyyliin vastaava osoite kenttään.
  • Vapaaehtoinen Ohjelmointi 1 kurssilla: Hae myös lähdekoodit

2. Perusasetuksia joita kannattaa tehdä

Kannattaa tehdä ehkä hieman pieniä säätöjä. Säädöt voivat olla Workspace kohtaisia, joten tarkista ne jos vaihdat työtilaa.

  • Tab-merkit pois:
    • Windows/Preferences/Java/Code style/Formater/
    • Paina Edit. Jos sinulla ei ole vielä omaa asettelutiedostoa, niin anna nimi ja tallenna.
    • Indentation, Tab policy: Spaces only
  • Samalla kannattaa ottaa kommenttien muotoilu pois niin testit toimivat:
    • Comments ja ruksi pois ruudusta: Enable Javadoc comment formating
  • Virheet päälle puutuvista kommenteista:
    • Window/Preferences/Java/Compiler/Javadoc
    • Ruksit kaikkiin kohtiin ja tasoiksi Error ja näkyvyydeksi protected
  • Virheet päälle jos @Override-huomautus puuttuu
    • Window/Preferences/Java/Compiler/Erros/Warnings
    • Annotations kohta auki ja siinä Missing '@Override annotation" kohtaan error
  • Oikoluku pois (ei oikolue suomea, käyttökelppoinen kun kirjoitetaan kommentit engalnniksi
    • Windows/Preferences
    • kirjoita hakulootaan spell -> Spelling ja ota oikoluku pois (ruksi)
  • Päivämäärän automaattinen lisääminen kommentteihin
    • Windows/Preferences
    • kirjoita hakulootaan templa ja valitse Java/Code Style/Code Templates
    • Aukaise Comments ja valitse Types
    • Edit ja muuta muotoon (muuttujat saat tuolta Insert variable...):
      /**
       *
       * @author ${user}
       * @version ${date}
       * ${tags}
       */
      

3. Vinkkejä

3.1 Asetuksia ja pikanäppäimiä

  • Asetuksia löydät helpoiten:
    • Window/Preferences
    • Kirjoitat tyhjään laatikkoon mitä haluat etsi, esim näppäimistöjuttuja varten kirjoita key
  • Ctrl-m maksimoi ja palauttaa aktiivisen editointi-ikkunan
  • Vaihda Window/Prefereneces/Gemeral/Keys -kohdasta itsellesi pikanäppäin mm- ohjelman ajamiseen. Huomaa kaikki komennot näkyvät (Eclipse 3.4) kun ruksii: Include Unpound Commands
  • Jos näyttää virhettä tai varoitusta, niin muista Quick Fix (Ctrl-1 viallisen rivin päällä)
  • Tee komento jolla voit käynnistää Eclipsen komentoriviltä. Mulla on esim. ec36.bat:
    @echo off
    start "Eclipse" "C:\devel\ee36\eclipse\eclipse.exe" -configuration "c:\MyTemp\eclipse36" %* -vmargs -XX:MaxPermSize=256m  -XX:PermSize=128m
    
    Toki muuta polkuja tuosta tarpeen mukaan. Linuxissa kuulema hyvin toimivia arvoja ovat olleet:
    -Xms128m (oletus 40m)
    -Xmx512m (oletus 256m)
    -XX:MaxPermSize=256m (128m:kin toimi ihan kivasti)
    -XX:PermSize=128m (64m:kin toimi ihan kivasti)
    

3.2 Muita käyttöohjeita

4. Tiedostojen yhteiskäyttö

4.1 Yksittäisen Java-tiedoston siirto ja käyttö

Alla muutamia vaihtoehtoja käyttää tätä. Esimerkeissä oletetaan, että mielenkiintoisen tiedoston nimi on Muunnokset.java.

  • tiedoston siirto suoraan u:-levyltä
    1. oletetaan että sinulla on yliopiston u:-levyllä Java-tiedostoja
    2. avaa Eclipse
    3. luo uusi projekti tai käytä olemassa olevaa
    4. avaa ssh ohjelmalla (tai vastaavalla) yhteys jalava.cc.jyu.fi-koneeseen.
    5. aukaise ssh:n tiedostohallinta (Window/New File Transfer). Siirry hakemistoon u ja etsi sieltä Muunnokset.java.
    6. raahaa Muunnokset.java projektin src-hakemiston päälle ja pudotat.
    7. ajele Muunnokset.javaa iloisena
  • tiedoston siirto
    1. oletetaan että muualla tekemäsi Java-tiedosto on vaikka muistitikulla hakemistossa d:\kurssit\ohj1\demot\demo3\src\.
    2. avaa Eclipse
    3. luo uusi projekti tai käytä olemassa olevaa
    4. kopioi d:\kurssit\ohj1\demot\demo3\src\Muunnokset.java Eclipse-projektisi hakemistoon
    5. kaikista helpointa tämä on kun avaa tiedostonhallintatyökalun ja hiirellä vedät haluamasi Java-tiedoston projektin src-hakemiston päälle ja pudotat.
    6. ajele Muunnokset.javaa iloisena
  • Import:
    1. avaa Eclipse
    2. luo uusi projekti tai käytä olemassa olevaa
    3. klikkaa projektia oikealla hiiren napilla Import.../General/File System
    4. valitse lähdepaikka ja klikkaile mitä tiedostoja otetaan
    5. ajele Muunnokset.javaa iloisena
  • Copy/Paste?:
    1. avaa Eclipse
    2. luo uusi projekti tai käytä olemassa olevaa
    3. luo projektiin uusi luokka (esimerkissä nimelle Muunnokset)
    4. aukaise d:\kurssit\ohj1\demot\demo3\src\Muunnokset.java vaikka Contextilla
    5. maalaa kaikki (Ctrl-A) ja laita leikepöydälle (Ctrl-C)
    6. Siirry Eclipseen Muunnokset-luokkaan ja maalaa kaikki (Ctrl-A) ja liimaa tilalle (Ctrl-V)
    7. ajele Muunnokset.javaa iloisena

Jos kopioit projektisi hakemistoon Eclipsen näkemättä uusia tiedostoja, niin paina Eclipsessä projektin päällä F5 (=refresh) virkistääksesi Eclipsen näkymän hakemistoon.

4.2 Olemassa olevan projektin tai samassa hakemistossa olevan Java-tiedoston käyttö

Oletetaan että olet kopioinut tavalla tai toisella koko projektin tai sen Java-tiedostoja vaikka hakemistoon c:\kurssit\ohj1\demot\demo3. Nyt jos haluat luoda tästä projektin omaan workspaceesi, niin

  1. File/New/Java Project
  2. anna hyvä projektin nimi (esimerkissä demo3 olisi hyvä)
  3. valitse Create project from existing source
  4. Kirjoita tähän (tai etsi) c:\kurssit\ohj1\demot\demo3
  5. Jatka kuten muulloinkin projektin luonnissa.

4.3 Kaikkien tiedostojen siirto muistitikulla

Mikäli itse siirtelee tiedostoja paikasta toiseen, niin siihen on useita mahdollisuuksia Jos kotona ja yliopistolla on täsmälleen samanlainen hakemistorakenne ja sama Eclipsen versio, niin silloin kaikki tiedostot voidaan kopioida sellaisenaan.

  • tällöin Eclipse "saattaa" toimia samalla tavalla molemmissa päissä
  • jos Workspacen kopiointi ei toimi, niin kopioi sitten syvemmältä projektin kohdalta (sovella ala olevaa esim. u:\kurssit\ohj1\demot\demo3)
  • yliopistolla muistitikku koneeseen
          cd /d u:\kurssit\ohj1
          kopioi *.* d:: /s /q
    
  • kotikoneelle U:-levyn vastine saadaan esim:
          subst u:\  c:\   (tai vaikka joku c tai muun levyn hakemistokin voi olla tuossa)
    
  • kotona tiedostot siirretään siellä u-levylle:
          cd /d u:\kurssit\ohj1
          kopioi *.* d:: /s /q
    
  • kopioi-komennon saat kotiin ottamalla tuolta kopioi.exe

4.4 U:-levyn Mounttaus" kotoa

U:-levy on mahdollista "mountata" myös kotoa. Tähän löytyy ohjeita Ohjelmointi 2-kurssin Wikistä kohdasta alkuvalmisteluja.

  • tällöin yliopiston u:-levy kannattaa mountata vaikka y:-levyksi ja oma levy substilla u:-levyksi.
  • sitten aina tiedoston siirtoon:
          cd /d u:\kurssit\ohj1
          kopioi *.* y:: /s /q
    

4.5 Versionhallinta

"Lopullinen" ratkaisu tiedostojen yhteiskäyttöön olisi versionhallinnan käyttö (esim. svn). Tämä on kuitenkin vielä hieman liian monimutkaista tähän alkuvaiheeseen. Kuitenkin jos saman tiedoston muokkaajia on useampia, on versionhallinta ainoa järkevä mahdollisuus. Tämän kurssin URL:

https://svn.cc.jyu.fi/srv/svn/ohj1s09/

tämän alle käyttäjän nimellä hakemisto ja sinne saa laittaa omia tiedostojaan.

5. Vikamahdollisuuksia

  • Väärä Javan versio. Kirjoita komentoriviltä
    java -version
    
    pitäisi tulla jotakin tyyliin:
    java version "1.6.0_03"
    Java(TM) SE Runtime Environment (build 1.6.0_03-b05)
    Java HotSpot(TM) Client VM (build 1.6.0_03-b05, mixed mode, sharing)
    
    jos tulee vanhempi, etsi syy. Se voi olla että sinulla on muita Javoja asennettuna ja ne tulevat polusta ensin näkyville.
  • Eclipse sulkeutuu itsestään ennen workspacen valintaa. Kannattaa poistaa Eclipsen Configuration kansio. Mikroluokissa tämä on u:\config-hakemistossa.
  • Jos uusia asennuksia tehdessä valittaa features.xml -tiedostosta, niin tuhoa site.xml eclipsen hakemistosta.

6. Plugineja

  • kannattaa ehkä asentaa PMD, joka neuvoo oikeita ohjelmointitapoja jo alusta alkaen

7. Eclipse ja Vista 64

8. Eclipse ja Mac OS X

Hae Eclipse osoitteesta http://www.eclipse.org/ tai katso kohtaa 1. yllä. Tuplaklikkaus tiedostoon Safarin Lataukset-ikkunassa purkaa sen paketista. Voit käyttää Eclipseä suoraan tästä hakemistosta, mutta on parempi viedä se muiden ohjelmistojen pariin. Raahaa syntynyt eclipse-hakemisto Ohjelmat-hakemistoon (Applications). Käynnistä Eclipse ikonistaan. Eclipsen käyttö on samanlaista kuin muissakin käyttöjärjestelmissä, mutta pikanäppäimet eroavat Windowsin ja Linuxin vastaavista. Esimerkiksi ohjelman ajo ensimmäisen kerran jälkeen tapahtuu Shift-Cmd-F11-näppäilyllä (⇧⌘-F11) ja debuggaus Cmd-F11-näppäilyllä (⌘-F11).

Jos haluat antaa "komentoriviparametrejä" Eclipselle käynnistyksen yhteydessä, tulee ne käydä kirjoittamassa eclipse.ini-tiedostoon. Tämä tiedosto löytyy klikkaamalla eclipse-ohjelman ikonia hiiren oikealla napilla (kyllä, sellainen on, voit myös klikata ikonia Ctrl-nappi alhaalla vasemmalla hiiren napilla) ja valitsemalla valikosta 'Näytä pakkauksen sisältö'. Sieltä löytyy kansio 'Contents/MacOS', jonka sisällä eclipse.ini lymyilee. Muokkaa sitä suosikkieditorillasi.

9. Graafinen käyttöliittymäeditori