Sisällys 20. Javan omat luokat Application Programming Interface (API). Pakkaukset. Merkkijonoluokka String. Math-luokka. Kääreluokat. 20.1 20.2 Java API Java-kielen Application Programming Interface (API) on kokoelma Javan omia luokkia, joista osa on valmiiksi ohjelmoitu ja osa määrittelee rajapintoja. Javan versiokohtainen API-dokumentaatio on luettavissa Internetissä. Esimerkiksi version 1.7 dokumentit löytyvät osoitteesta: http://docs.oracle.com/javase/7/docs/api/index.html Linkki kurssin verkkosivuilla. Pakkaukset API on jaettu pienempiin kokonaisuuksiin eli pakkauksiin (package), koska Javan omia luokkia on satoja. java.lang-pakkauksen luokkia (esimerkiksi String ja Math) voidaan käyttää suoraan ilman eri pyyntöä. Pakkaukset sijaitsevat nimeään vastaavissa alihakemistoissa: esimerkiksi java.lang-paketin luokat ovat Java-ympäristön alihakemistossa java\lang 20.3 20.4
Pakkaukset Nyt riittää tietää kuinka pakkauksen luokat saadaan käyttöön - pakkauksia ei tarvitse osata tehdä itse. Pakkauksen luokat tuodaan ohjelman käyttöön import-lauseella, jolla voidaan sisällyttää useampia pakkauksia. import-lauseet tiedoston alkuun ennen luokkaa. // Esim. Käyttöön java.util-pakkauksen kaikki luokat. import java.util.*; public class PakettiTesti { } Vaikka merkkijonot ovat String-luokan olioita, tämän tyyppiset tunnukset voidaan esitellä, ja niihin voidaan myös sijoittaa, alkeistyyppien tapaan. String tervtre = "Moro!"; String tervkuo = new String("Päevee!"); Merkkijonoliteraalit merkitään lainausmerkeillä. Pienet ja isot kirjaimet ovat eri asia. +-operaatiolla merkkijonoihin voidaan yhdistää alkeistyyppisiä arvoja ja merkkijonoja. 20.5 20.6 Luokan palvelut saatavilla ilman import-lausetta. Koska String-luokan metodit eivät kuulu omaan ohjelmaan (luokkaan), metodeja kutsutaan pistenotaatiolla joko olion tai luokan nimen kautta. String mjono = "ABC - kissa kävelee."; int mjonopit = mjono.length(); // 20 String mjono = String.format("%.2f", osamaara); 20.7 Merkkeihin viitataan nollasta alkavalla indeksillä. Ensimmäinen kirjain on kohdassa 0, toinen kohdassa 1 ja viimeinen kohdassa n 1, missä n on jonon pituus. Indeksi 0 1 2 3 Merkki J a v a Indeksiarvoja annetaan monien String-luokan metodien parametreiksi. Huom! Yksiulotteiset taulukot ovat eri asia kuin merkkijonot! 20.8
int length()-metodi palauttaa merkkijonon pituuden. String mjono = "Java"; int l = mjono.length(); // 4 Tietty merkkijonon kirjain voidaan lukea char charat(int i)-metodilla, missä parametri i on indeksi ja operaation tuloksen tyyppi char. char toinenmerkki = mjono.charat(1); // a int indexof(int c)-metodi palauttaa merkin c ensimmäisen paikan merkkijonossa. Mikäli merkkijono ei sisällä merkkiä, palautetaan -1. String mjono = "Java"; int i = mjono.indexof('a'); // 1 int j = mjono.indexof('q'); // -1 20.9 20.10 boolean equals(string s)-metodi tutkii ovatko merkkijonojen merkit samat. Yhtä- ja erisuuruusoperaatiot (==,!=) eivät sovellu merkkijonomuuttujien vertailuun. String mjono1 = new String("Java"); String mjono2 = new String("Java"); // true boolean samat1 = mjono1.equals(mjono2); // false boolean samat2 = mjono1 == mjono2; 20.11 valueof(int c)-metodi muuntaa alkeistyyppisen parametrinsa merkkijonoksi. Metodi on kuormitettu: parametri voi olla esimerkiksi int- tai double-tyyppinen. String klmjono = String.valueOf(123); String llmjono = String.valueOf(1.23); String-tyyppistä merkkijonoa ei voi muuttaa. Ei metodia esimerkiksi yksittäisen merkin muuttamiseen. StringBuffer- ja StringBuilder-tyyppiset jonot muuttuvat. 20.12
public class VaihdaKirjain { public static void main(string[] args) { String sana = "Saari"; // Muutettava merkkijono. char vanhamerkki = 'a'; // Vanha merkki. char uusimerkki = 'i'; // Uusi merkki. String apu = ""; // Väliaikainen muuttuja. for (int i = 0; i < sana.length(); i = i + 1) if (sana.charat(i) == vanhamerkki) // Löytyi vaihdettava merkki. apu = apu + uusimerkki; else // Jokin muu merkki. apu = apu + sana.charat(i); sana = apu; System.out.println(sana); } } Math-luokka Luokan rakentaja yksityinen Luokasta ei voida luoda olioita. Vain luokkametodeja, joita kutsutaan luokan nimen kautta. // Satunnaisluku väliltä [0, 1[. double satluku = Math.random(); 20.13 20.14 Joitakin Math-luokan metodeja abs-metodi palauttaa parametrinsa itseisarvon. Metodi kuormitettu siten, että parametri voi olla double-, float-, int- tai long-tyyppiä. double lluku = -1.23; lluku = Math.abs(lluku); // 1.23 int kluku = -10; System.out.println(Math.abs(kluku)); // 10 Joitakin Math-luokan metodeja min(a, b) Palauttaa pienemmän parametreistaan a ja b. max(a, b) Palauttaa suuremman parametreistaan a ja b. round(a) pow(a, b) sqrt(a) Pyöristää liukulukutyyppisen parametrinsa. Palauttaa pyöristetyn arvon. b Potenssiin korotus a. Palauttaa tuloksen. Neliöjuuren lasku a. Palauttaa tuloksen. 20.15 20.16
Kääreluokat java.lang-pakkaus sisältää alkeistyyppejä vastaavat niin sanotut kääreluokat (wrapper class). Esim. double-tyyppiä vastaa Double-luokka. Rakentajille voidaan antaa parametriksi joko alkeistyypin arvo tai merkkijono. Esim. Double d = new Double(1.23); Java käärii alkeistyyppisiä arvoja myös automaattisesti. Esim. Double d = 1.23; Kääreluokkien valueof-metodilla voidaan muuttaa merkkijono kääreluokan olioksi ja tostring-metodilla olio merkkijonoksi. Esim. Integer luku = Integer.valueOf("10"); 20.17