Dokumentation af geonøgler Classic - Kortforsyningen
Dokumentation af geonøgler Classic - Kortforsyningen
Dokumentation af geonøgler Classic - Kortforsyningen
You also want an ePaper? Increase the reach of your titles
YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.
Kort & Matrikelstyrelsen<br />
<strong>Kortforsyningen</strong> Version 2.13, 2010-05-21<br />
Fejlhåndtering/exceptions<br />
Hvis man ikke har opbygget sin URL ud fra retningslinjerne beskrevet tidligere vil man få en<br />
fejlmeddelelse retur i stedet for søgeresultatet. Fejlmeddelelser returneres i det format som<br />
parameteren EXCEPTIONS angiver. Er EXCEPTIONS ikke angivet vil fejlmeddelelsen<br />
returneres i ASCII.<br />
Bearbejdning <strong>af</strong> output<br />
Laves et http request med en URL jf. <strong>af</strong>snittet Opbygning <strong>af</strong> URL vil man i en Internet-browser<br />
se det returnerede resultat se figur nedenfor til venstre. Vil man arbejde videre med resultatet i<br />
en applikation (fx vil man gerne trække koordinaterne ud <strong>af</strong> resultatet med henblik på at få vist<br />
positionerne på et kort) må man manipulere med resultatet, man fik returneret. For at kunne<br />
arbejde videre med outputtet kan man benytte en Java Applet eller, hvis man har valgt<br />
returformatet XML, en XML-parser. Der findes adskillige XML-parsere, bl.a. leveres der en med<br />
Microsoft Internet Explorer. Vil man benytte en Java Applet, så skal man bruge den, der ligger på<br />
kortforsyningen.kms.dk, idet en Java Applet installeret på en anden maskine medfører brud på<br />
Java Net Security. Java Appleten kan tilgås via http://kortforsyningen.kms.dk/web/jpost.class.<br />
Java Appleten har en funktion, der kan requeste den opbyggede URL og skrive resultatet til en<br />
variabel i stedet for at få vist resultatet direkte i en Internet-browser. Ved at skrive resultatet til en<br />
variabel kan man manipulere resultatet og på den måde få trukket lige netop de informationer ud,<br />
som man er interesseret i. Dem kan man efterfølgende vise i Internet-browseren. Nedenstående<br />
eksempel viser, hvordan Java Appleten benyttes.<br />
Eksempel på en applikation<br />
1 Design web-siden<br />
Indtast eller indsæt HTML kildekoden fra Appendiks B i en HTML-editor og gem dokumentet<br />
(vælg selv et filnavn):<br />
2 Et par praktiske detaljer<br />
Gem dokumentet med et vilkårligt filnavn (lad det slutte på .htm eller .html). Husk også at have<br />
internetforbindelsen åben.<br />
3 Test applikationen<br />
Åbn hjemmesiden i en Internet-browser og test om det virker.<br />
4 Hvad gør koden?<br />
Nederst i HTML-koden indsættes Java Appletten. Vi er ikke interesseret i, at den skal vises, da<br />
den blot tager resultatet <strong>af</strong> vores søgning og skriver til en variabel. Derfor er dens bredde og<br />
højde sat til 0. Der er også en tekstfelt med navnet txtStednavn, hvori vi kan skrive det stednavn,<br />
vi søger, ligesom der også er en listboks med navnet lstMaxHits, hvor vi kan vælge det ønskede<br />
antal maksimale resultater. Endelig er der en knap med teksten Søg, som vi kan trykke på for at<br />
starte søgningen. Til denne knap er der knyttet hændelsen onclick, det vil sige, når der med<br />
musen klikkes på knappen. Når denne hændelse indtræffer <strong>af</strong>vikles funktionen CreateTable() som<br />
også benytter funktionen BuildURL(). Funktionerne er skrevet i JavaScript, der er et makrosprog<br />
til brug på web-sider. CreateTable() kalder også funktionen postURL() i JavaAppletten. Den<br />
funktion laver et http request med vores URL, som blev opbygget i BuildURL() vha. det stednavn<br />
vi har indtastet samt vores valg <strong>af</strong> maksimale resultater i listboksen. Funktionen postURL()<br />
returnerer herefter resultatet til variablen Results. Denne variabel benytter vi til at trække<br />
informationerne ud <strong>af</strong>, og skrive dem i en tabel. Denne tabel udskrives herefter i vores Internetbrowser.<br />
Der er her ikke yderligere forklaringer til CreateTable(), da der er kommentarer i<br />
JavaScript-koden.<br />
Læg mærke til at Java Appletten ikke gør noget, før vi trykker på knappen med teksten Søg. For<br />
at vi overhovedet kan kalde Java Appletens metode fra JavaScript skal Java Appleten navngives i<br />
HTML-koden. Dette gøres med attributten name fx name=myapplet, hvor attributtens værdi<br />
sættes til myapplet.<br />
Side 83 <strong>af</strong> 94