Taito pääsisältöön

Ohjelmoijan opas

Nämä ovat asioita, joiden kanssa vain ohjelmoija haluaa työskennellä.ERDDAP>JavaLuokkien on tiedettävä.

Lähdekoodi​

 

  • Lähdekoodi GitHubissa Myös viimeaikaisten julkisten versioiden ja kehitysversioiden lähdekoodi on saatavillaGitHub. Ole hyvä ja lueWikitähän projektiin. Jos haluat muuttaa lähdekoodia (Muutokset on mahdollisesti sisällytetty standardiinERDDAP™Jakelu jakautuu) Tämä on suositeltu lähestymistapa.

ERDDAP™Riippuvuus​

ERDDAP™Maven käyttää koodiriippuvuuksia sekä joitain staattisia viitetiedostoja (WEB INF/ref) . Näin vältytään tallentamasta suuria tiedostoja tallennustilaan. Voit käyttää mvn-kokoonpanoa ja se hakee riippuvuuksia ja ref-tiedostoja. Voit myös käyttää mvn-pakettia luodaksesi sotatiedoston. Voit ladata ref-tiedostoja manuaalisesti:

HUOMAUTUS: Oletusarvoisesti Maven välittää staattisia viite- ja testitietoarkiston latauksia ja poistaa ne vain, kun uusi versio ladataan. Jos haluat ohittaa latauksen kokonaan, voit asettaa "skipResourceDownload" ja / tai "skipTestResourceDownload" ominaisuudet Maven (esim. mvn-DskipResourceDownload -paketti > >) . Pakottaa uutto, aseta "-Ddownload.unpack=true" ja "Ddownload.unpack WhenChanged=false"

  • ERDDAP™Alikomponenteilla on hyvin liberaali, avoimen lähdekoodinLisenssitVoit käyttää ja muokata lähdekoodia mihin tahansa tarkoitukseen, voittoa tai voittoa tavoittelemattomaan. Huomaa, ettäERDDAP™Monilla alikomponenteilla on lisenssejä, jotka edellyttävät, että tunnistat käyttämäsi koodin lähteen. NäytäLuottoa. Vaatii tai ei, on hyvä tunnistaa kaikki nämä tekijät.

  • Käytä koodia muihin hankkeisiin

Kun olet tervetullut käyttämään osiaERDDAP™Muiden projektien koodia varoitetaan, että koodi voi ja muuttuu. Emme lupaa tukea koodimme muita käyttötapoja. Git ja GitHub ovat tärkeimpiä ratkaisujasi tämän käsittelyyn – Git mahdollistaa muutostemme yhdistämisen. Monissa tilanteissa, joissa saatat olla kiusattu käyttää osiaERDDAP™Projektissasi uskomme, että sinun on helpompi asentaa ja käyttääERDDAP™Kuten on, Kirjoita sitten muita palveluja, jotka käyttävätERDDAPpalvelut. Voit luoda omanERDDAP™Asentaminen tunnissa tai kahdessa. Voit luoda omanERDDAP™Asentaminen kiillotetulla tavalla muutamassa päivässä (riippuen tietojesi määrästä ja monimutkaisuudesta) . Hakkerointi osatERDDAP™Oma projekti kestää todennäköisesti viikkoja. (Kuukaudet saada hienovaraisia) ja menetät kyvyn sisällyttää muutoksia ja virhekorjauksia myöhemmästäERDDAP™vapauttaa. Me olemme (Ilmeisesti) On monia etuja käyttääERDDAP™Niin kuin on ja tekeeERDDAP™julkisesti saatavilla. Joissakin tilanteissa et ehkä halua tehdäERDDAP™julkisesti saatavilla. Palvelu voi käyttää ja käyttää yksityistäERDDAP™Asiakkaiden ei tarvitse tietääERDDAP™.

Puolikas​

Tai on olemassa toinen lähestymistapa, josta voi olla hyötyä, joka on puolivälissä.ERDDAPkoodi ja käyttöERDDAP™Yksityinen verkkopalvelu: EDD-luokassa on staattinen menetelmä, jonka avulla voit määrittää tietoaineiston. (spesifikaatioiden perusteelladatasets.xml) : OneFromDataset XM (TDatasetidiä) Se palauttaa EDD-taulukon taiEDDGridDataa. Ottaen huomioon, voit soittaa MakeNewFileForDapQuery (käytetty) (String userDapQuery, String dir, String fileName, String-tiedosto Typen nimi) ”Kerro tapaus tehdä tietotiedosto, tietyn tiedostotyypin, käyttäjäkyselyn tuloksilla. Tämä on yksinkertainen tapa käyttääERDDAPmenetelmät tietojen pyytämiseksi ja tiedoston saamiseksi vastauksena, kuten asiakas käyttääERDDAP™Web-sovellukset. Tämä lähestymistapa toimii sinun sisälläsiJavaOhjelmoi ja ohittaa Tomcatin kaltaisen sovelluspalvelimen tarpeen. Käytämme tätä lähestymistapaa useisiin EDDTable-yksikön testeihin jaEDDGridAlaluokkia, joten voit nähdä esimerkkejä tästä lähdekoodissa kaikki nämä luokat.

Kehitysympäristö​

  • on konfiguraatioitaJeejaDockerGitHubissa julkaisujen odotetaan toimivan Tomcatissa.

  • Vaihtoehtoinen : Aseta ylösERDDAP™Tomcatissa Siitä lähtienERDDAP™Se on tarkoitettu pääasiassa Tomcatissa toimivaksi palvelimeksi, suosittelemme vahvasti, että noudatat standardia.AsennusohjeetAsenna Tomcat ja asenna sittenERDDAP™Tomcatin webapps-hakemistossa. muun muassa,ERDDAP™Se on suunniteltu asennettavaksi Tomcatin hakemistoon ja odottaa Tomcatin tarjoavan .jar-tiedostoja.

  • ERDDAP™ei vaadi erityistä tunnustusta (Chris käyttää pääasiassa Visual Studio Codea, Bob käyttää EditPlusia.) . Emme käytä Eclipse, Ant, jne. emmekä tarjoaERDDAPniihin liittyvää tukea. Projekti käyttää Mavenia.

  • Käytämme erätiedostoa, joka poistaa kaikki .class-tiedostot lähdepuusta varmistaaksemme, että meillä on puhdas kokoelma. (Javac) .

  • Tällä hetkellä käytämme Adoptiumin javac jdk-21.0.3+9:ää gov.noaa.pfeg.coastwatch.TestAll. (Sillä on linkkejä joihinkin luokkiin, joita ei muuten olisi koottu.) ja suorittaa testejä. Turvallisuussyistä on lähes aina parempi käyttää uusimpia versioita.Java21 ja Tomcat 10.

    • Javac tai Java, nykyinen hakemisto on tomcat/webapps/erddap/WEB-INF.

    • Javac- ja Java-luokka on ’luokat’;/./././lib/servlet-api.jar;lib/*

    • Javac-komentosi on jotain sellaista. ’javac-koodaus UTF-8-cp-luokkia;.../.././././lib/servlet-api.jar;lib/*-luokat/gov/noaa/pfel/coastwatch/TestAll.java’

    • Java-komentolinjasi on kuin ’java-cp-luokat;.../././lib/servlet-api.jar;lib/* -Xmx4000M Luokat/Gov/noaa/Pfel/Castwatch/TestAll "Valinnainen: voit lisätä "verbose:gc", joka kertooJavaJätteiden keräystilastot.

    • Jos testi Kaikki kootut, kaikkiERDDAP™Tarpeet on koottu. Muutamia luokkia on koottu, joita ei tarvitaERDDAP™. Jos TestAllin kokoaminen onnistuu, mutta ei kokoa luokkaa, sitä ei tarvita. (On olemassa keskeneräisiä / käyttämättömiä luokkia.)

  • Joissakin tapauksissa käytämme kolmannen osapuolen lähdekoodia .jar-tiedostojen sijaan. (erityisestiDODS) ja muuttanut niitä hieman, jotta vältettäisiin ongelmat.JavaUsein on tehty pieniä muutoksia (erityisestiDODS) muista syistä.

  • Useimmilla luokkilla on testimenetelmät src/test-tiedostossa. Voit suorittaa JUnit-testit mvn-komennolla. Tämä lataa useita zip-tiedostoja, joita testit luottavat uusimpaan julkaisuun.ERDDAPEddap Testi. . \   HUOMAUTUS: Maven Caches lataa, mutta poistaa ladatut arkistot jokaisesta suorituksesta, joka vie aikaa. Lataa skip lataus ja poistaa testitietoarkistot, voit määrittää "skipTestResourceDownload"-ominaisuuden Maven (esim. mvn-DskipTestResourceDownload -paketti > >) .

Tärkeitä luokkia​

Jos haluat tarkastella lähdekoodia ja yrittää selvittää, mitenERDDAP™Työt, olkaa hyvä.

  • Koodilla onJavaKommentteja, muttaJavaDocsia ei ole kehitetty. Tuntuu vapaalta luoda niitä.

  • Tärkeimmät luokat (Alla mainitut) Sisältää gov/noaa/pfel/erddap.

  • TheERDDAP™Luokalla on korkeimmat menetelmät. Se laajentaa HttpServletia.

  • ERDDAP™pyynnöt alaryhmilleEDDGridEDDTable, joka edustaa yksittäisiä tietoaineistoja.

  • EDStaticilla on suurin osa staattisista tiedoista ja asetuksista. (esim. asennus.xml ja viestit.xml-tiedostot) tarjoaa staattisia palveluja (esimerkiksi sähköpostien lähettäminen) .

  • EDDGridja EDDTable-alaluokat täyttävät pyynnön, saavat tietoja alaluokkakohtaisista menetelmistä ja muotoilevat sitten vastauksen tiedot.

  • EDDGridAliluokka työntää tietoja GridDataAccessoriin (Sisäinen tietosäiliö verkkotietoihin) .

  • EDDTable-alaluokat työntävät tietoja TableWriter-alaluokkiin, jotka kirjoittavat tietoja tietylle tiedostotyypille lennossa.

  • Muut luokat (mm. matalan tason luokat) Se on myös tärkeää, mutta on epätodennäköistä, että muutat niitä.  

Koodin panokset​

  • GitHub-kysymykset Jos haluat osallistua, mutta sinulla ei ole projektia, katso luetteloGitHub-kysymyksetMonet niistä ovat hankkeita, joita voit toteuttaa. Jos haluat työskennellä ongelman parissa, ilmoita siitä itsellesi muille, jotka työskentelet sen parissa. GitHub-kysymys on paras paikka keskustella mahdollisista kysymyksistä, miten käsitellä tätä asiaa.

  • Jos muutos, jonka haluat tehdä, on yksi alla olevista tapauksista, luoGitHubin ongelmaSe kertoo muutoksesta, jonka aiot tehdä. Sitten kun muutos on valmis, tee vetopyyntö pyytää sulautumista. Yhteisiä muutoksia ovat:

    • Haluat kirjoittaa toisen alaluokanEDDGridEDDTable käsittelee toisen tietolähteen tyyppiä. Jos näin on, suosittelemme, että löydät lähimmän olemassa olevan alaluokan ja käytät koodia lähtökohtana.

    • Haluaisit kirjoittaa toisen menetelmän (As_FileType). Jos näin on, suosittelemme, että löydät lähimmän olemassa olevan tallennuksen.EDDGridEDDTable ja käytä koodia lähtökohtana.

Näissä tilanteissa on etu, että kirjoittamasi koodi on itsenäinen. Sinun ei tarvitse tietää kaikkia yksityiskohtiaERDDAPsisäisiä. Meidän on helppo sisällyttää koodiERDDAP. Huomaa, että jos lähetät koodin, lisenssi on yhteensopivaERDDAP™ lisenssi lisenssi lisenssi lisenssi (esim.Apasseja,BSDtaiMIT-X) . Listaamme panoksenne tähänLuottoa.

  • Jos sinulla on ominaisuus, jota ei ole yllä, haluat lisätäERDDAPOn suositeltavaa ensin luoda keskusteluketjuGitHub-keskustelut. Merkittävien ominaisuuksien/muutosten osalta tekninen hallitus keskustelee niistä ja päättää, hyväksyykö se niiden lisäämisen.ERDDAP™.

Tuomitse koodisi panokset​

Jos haluat lisätä koodin tai muut muutokset, jotka sisältyvätERDDAPSe on suuri. Panoksen on täytettävä tietyt kriteerit, jotta se voidaan hyväksyä. Jos noudatat alla olevia ohjeita, lisäät huomattavasti todennäköisyyttä, että panoksesi hyväksytään.  

  • TheERDDAP™Hanketta hallinnoi NATD (NOAATekninen johtaja) Teknisen hallituksen tulos. 2007 alkaen (AlkuaERDDAP) Vuoteen 2022 mennessä Bob Simons (Myös perustajajäsen) . Tammikuusta 2023 alkaen se on Chris John. NATD on vastuussaERDDAPh) hänellä on viimeinen sana päätöksistäERDDAP™koodi, erityisesti suunnittelusta ja siitä, hyväksytäänkö tietty vetopyyntö vai ei. Näin on tehtävä osittain tehokkuussyistä. (Linus Torvalds ja Linux) osittain turvallisuussyistä: Jonkun on kerrottava tietoturvahenkilöille, että hän ottaa vastuun koodin turvallisuudesta ja koskemattomuudesta.  

  • NATD ei takaa, että hän hyväksyy koodin. Jos projekti ei vain toimi niin kuin olimme toivoneet ja jos sitä ei voida pelastaa, NATD ei sisälly projektiin.ERDDAP™Jakelu. Älä tunne pahaa. Joskus projektit eivät toimi kuten toivottiin. Tämä tapahtuu kaikille ohjelmistokehittäjille. Jos noudatat alla olevia ohjeita, lisäät suuresti menestymismahdollisuuksiasi.  

  • On parasta, että muutokset ovat yleistä kiinnostusta ja hyötyä. Jos koodi on erityinen organisaatiollesi, on parempi ylläpitää erillistä haaraa.ERDDAP™käyttöösi. Axiom tekee niin. Onneksi Git tekee tämän helpoksi. NATD haluaa säilyttää yhtenäisen visionERDDAPÄlä anna sen tulla keittiön uppoamishankkeeksi, jossa jokainen lisää projektilleen mukautetun ominaisuuden.  

  • SeuraaJavaYleissopimuksia. Yleisesti ottaen koodin on oltava laadukas ja sen on noudatettava alkuperäistäJavaKoodisopimukset: laittaa .class-tiedostoja oikeaan paikkaan hakemistorakenteessa, antaa .class-tiedostoja sopiva nimi, sisällyttää oikea nimi.JavaDoc-kommentteja, jotka sisältävät //kommentteja kunkin koodin kappaleen alussa, joka on lueteltu neljällä tilalla. (Ei tab) Vältä > 80 merkkiä jne. Sopimukset muuttuvat, eikä lähdekoodi ole aina täysin ajan tasalla. Jos epäilet, sovi koodi sopimuksiin eikä olemassa oleviin koodiin.

  • Käytä kuvailevia luokkia, menetelmiä ja muuttuvia nimiä. Tämä helpottaa muiden lukemista.  

  • Vältä fantasiakoodia. Pitkällä aikavälillä sinun tai muiden on selvitettävä koodi, jotta voit säilyttää sen. Käytä yksinkertaisia koodausmenetelmiä, jotka helpottavat muita. (mukaan lukien tulevaisuudessa) selvittää. Tietenkin, jos on todellista etua käyttää joitakin fancy.JavaOhjelmointiominaisuus, käytä sitä, mutta dokumentoi laajasti, mitä olet tehnyt, miksi ja miten se toimii.  

  • Työskentele tekniikan kanssa ennen kuin aloitat. Jos haluat, että koodisi muuttuuERDDAP™Tekninen hallitus haluaa ehdottomasti puhua siitä, mitä aiot tehdä ja miten aiot tehdä sen ennen kuin teet muutoksia koodiin. Näin voimme välttää tekemästä muutoksia, joita Suomi lopulta ei hyväksy. Kun teet työtä, NATD ja tekninen johto ovat valmiita vastaamaan kysymyksiin, jotta voit selvittää olemassa olevan koodin ja (Kokonaisuutena) Miten käsitellä projektiasi  

  • Työskentele itsenäisesti (mahdollisimman paljon) Kun aloitat. Toisin kuin edellä mainitussa "Työskentele teknillisen hallituksen kanssa", kun aloitat projektin, NATD kannustaa sinua työskentelemään mahdollisimman itsenäisesti. Jos NATD:n on kerrottava kaikki ja vastattava moniin kysymyksiin (erityisesti ne, joihin olisit voinut vastata lukemalla dokumentaatiota tai koodia.) Silloin ponnistelut eivät ole aikasäästöjä NATD:lle, ja hän voi myös tehdä työn itse. Se on seMyyttinen kuukausiongelma. Tietenkin meidän pitäisi kommunikoida. On hienoa nähdä säännöllisesti työsi etenevän varmistaakseen, että projekti on käynnissä. Mitä enemmän voit työskennellä itsenäisesti (Kun tekninen johtokunta on hyväksynyt tehtävän ja yleisen lähestymistavan) Mitä parempi.  

  • Vältä vikoja. Jos vika ei jää kiinni ennen julkaisua, se aiheuttaa ongelmia käyttäjille. (Parhaimmillaan) palauttaa väärän tiedon (Pahimmillaan) on blotti päälläERDDAPmaine ja pysyy ajan tasallaERDDAP™asennuksia vuosia. Työskentele kovasti välttääksesi vikoja. Osa tästä on puhtaan koodin kirjoittamista. (Ongelmia on helpompi nähdä) . Osa tästä on yksiköiden testien kirjoittamista. Osa tästä on jatkuva asenne virheiden välttelyyn, kun kirjoitat koodia. Älä tee NATD katumusta lisätä koodinERDDAP™.  

  • Kirjoita yksikön testi tai testi. Uusi koodi, sinun pitäisi kirjoittaa JUnit testit testitiedosto. Kirjoita vähintään yksi testimenetelmä, joka testaa perusteellisesti kirjoittamaasi koodia ja lisää sen luokan JUnit-testitiedostoon, jotta se suoritetaan automaattisesti. Yksikkö (ja liittyvät) Testit ovat yksi parhaista tavoista saada vikoja aluksi ja pitkällä aikavälillä. (Kun muut asiat muuttuvatERDDAP™) . Kuten Bob sanoi: "Kokeet antavat minun nukkua yöllä."  

  • Tee NATD:n helppo ymmärtää ja hyväksyä muutokset vetopyynnössäsi. Osa tästä on yksikön testimenetelmän kirjoittaminen (s) . Osa tästä rajoittaa muutoksia yhteen koodiin (Yksi luokka) Jos mahdollista. NATD ei hyväksy vetopyyntöä sadoilla muutoksilla koko koodin ajan. NATD kertoo tietoturvahenkilöille, että hän ottaa vastuun koodin turvallisuudesta ja eheydestä. Jos muutoksia on liian paljon tai niitä on liian vaikea selvittää, on liian vaikeaa tarkistaa, että muutokset ovat oikeita eivätkä esitä vikoja tai turvallisuusongelmia.  

  • Pidä se yksinkertaisena. Hyvä teema koodille on: Pidä se yksinkertaisena. Yksinkertainen koodi on helppo muille (mukaan lukien tulevaisuudessa) lukea ja ylläpitää. NATD:n on helppo ymmärtää ja hyväksyä.  

  • Ota pitkäaikainen vastuu koodistasi. Pitkällä aikavälillä on parempi, jos otat jatkuvan vastuun koodin ylläpidosta ja vastaat siihen liittyviin kysymyksiin. (Esim. SisälläERDDAP™Google Group) . Kuten jotkut kirjoittajat huomauttavat, koodi on myös omaisuuserä. Jos vika havaitaan tulevaisuudessa, se on parasta, jos korjaat sen, koska kukaan ei tiedä koodiasi paremmin kuin sinä. (On myös kannustin välttämään vikoja.) . NATD ei vaadi jatkuvaa ylläpitoa. NATD:n mukaan huoltoa arvostetaan suuresti.