Kuinka käyttää paikallista tallennustilaa ja JavaScript-interoperaatiota Blazorissa

Blazor tarjoaa joustavan ympäristön kehittää tehokkaita ja interaktiivisia web-sovelluksia. Yksi hyödyllinen ominaisuus on paikallisen tallennustilan (local storage) käyttö, joka mahdollistaa tietojen tallentamisen selaimeen ja niiden käyttämisen myöhemmin ilman, että joudutaan tekemään jatkuvia palvelinpyyntöjä. Paikallisen tallennustilan käyttäminen on erityisen hyödyllistä silloin, kun halutaan parantaa sovelluksen suorituskykyä ja mahdollistaa offline-toiminnot. Tässä käsitellään, kuinka Blazor-sovelluksessa voidaan käyttää paikallista tallennustilaa JavaScript-interoperaation avulla.

Kun tarkastellaan esimerkkiä, jossa käyttäjä voi tarkastella työntekijöiden tietoja eri maista, voidaan havaita, että ilman paikallista tallennustilaa, joka pitää tietoja muistissa, sovellus joutuu tekemään jatkuvia pyynnöitä web-palvelimelle joka kerta, kun sivua vaihdetaan tai päivitetään. Tämä ei ainoastaan heikennä suorituskykyä, vaan voi myös johtaa tarpeettomaan kuormitukseen palvelimelle ja pitkittyneisiin odotusaikoihin.

Paikallisen tallennustilan hyödyntäminen

Paikallinen tallennustila on erityisen hyödyllinen Blazor-sovelluksille, sillä se voi tallentaa suuria määriä tietoa, joka säilyy selaimessa myös silloin, kun sovellus suljetaan ja avataan uudelleen. Tämä on merkittävä etu verrattuna siihen, että sovellus tekisi web-pyyntöjä joka kerta, kun käyttäjä siirtyy uuteen näkymään tai päivittää sivua.

JavaScript-interoperaatio

Blazorissa JavaScriptin käyttöön tarvitaan interoperaatio (interop) JavaScriptin ja .NET:n välillä. Tämä mahdollistaa JavaScriptin käyttöä Blazor-komponenteissa ilman, että tarvitsee suoraan muokata HTML-sivustoa. Blazor käyttää IJSRuntime-rajapintaa, joka mahdollistaa JavaScript-moduulien dynaamisen lataamisen ja kutsumisen.

Kun JavaScript-moduuli on ladattu, voidaan käyttää sen tarjoamia funktioita, kuten set ja get, jotka käsittelevät local storagea. JavaScript-moduulissa määritellään funktiot tallentamiseen, hakemiseen ja poistamiseen:

javascript
Copy code
export function get(key) {

   return window.localStorage.getItem(key);
}
export function set(key, value) {
   window.localStorage.setItem(key, value);
}
export function remove(key) {
   window.localStorage.removeItem(key);
}
export function clear() {
   window.localStorage.clear();
}

Blazorissa JavaScript-moduuli ladataan ja käytetään seuraavasti:

csharp
Copy code
private Lazy<IJSObjectReference> jsModule = new();

private async Task WaitForReference()
{
    if (!jsModule.IsValueCreated)
    {
        jsModule = new(await jsRuntime.InvokeAsync<IJSObjectReference>(
            "import", "/js/LocalStorageInterop.js"));
    }
}

Paikallisen tallennustilan käyttö Blazorissa

Kehitetään Blazor-komponenttia, joka käyttää paikallista tallennustilaa työntekijätietojen välimuistiin. Tavoitteena on, että työntekijätietoja ei tarvitse hakea aina palvelimelta, vaan ne voidaan tallentaa selaimen muistiin tietyn ajan, esimerkiksi kymmenen minuutin ajaksi.

1. JavaScript-moduulin luominen: Ensimmäinen askel on luoda JavaScript-tiedosto, joka tarjoaa perustoimintoja local storagen käsittelemiseen.

2. C#-palvelun luominen: Seuraavaksi luodaan Blazor-palvelu, joka kommunikoi JavaScriptin kanssa. Tämä palvelu toimii välikätenä Blazor-komponentin ja JavaScriptin välillä, jolloin komponentti voi käyttää local storagea ilman suoraa JavaScript-koodin kirjoittamista.

3. Tiedon tallentaminen ja hakeminen: Palvelun avulla voidaan tallentaa työntekijätiedot ja hakea ne nopeasti selaimen muistiin. Jos tiedot ovat tallennettu, niitä käytetään suoraan ilman uutta palvelinpyyntöä, kunhan välimuistin voimassaoloaika ei ole umpeutunut.

Esimerkiksi työntekijätietojen näyttäminen voi tapahtua seuraavasti:

csharp
Copy code
@code {

   private const string keyTS = "employeesLastGet";

   private const string keyData = "employeesArray";

   [Parameter]
   public TimeSpan CacheDuration { get; set; } = TimeSpan.FromMinutes(10);
   [Parameter]
   public string? Country { get; set; }
   private IQueryable<Employee>? employees;

   protected override async Task OnParametersSetAsync()

   {
       string employeesJson = await localStorage.GetValueAsync(keyData);
       if (!string.IsNullOrEmpty(employeesJson))
       {
           var timestamp = await localStorage.GetValueAsync(keyTS);
           var timeSinceLastFetch = DateTime.UtcNow - DateTime.Parse(timestamp);
           if (timeSinceLastFetch < CacheDuration)
           {
               employees = JsonSerializer.Deserialize<IQueryable<Employee>>(employeesJson);
               return;
           }
       }
       // Hae tiedot palvelimelta ja tallenna ne välimuistiin
       var response = await httpClient.GetFromJsonAsync<Employee[]>($"api/employees/{Country}");
       employees = response?.AsQueryable();
       await localStorage.SetValueAsync(keyData, JsonSerializer.Serialize(employees));
       await localStorage.SetValueAsync(keyTS, DateTime.UtcNow.ToString());
   }
}

Tärkeää huomioida

Paikallisen tallennustilan käyttö Blazor-sovelluksessa ei ole pelkästään suorituskyvyn parantamista, vaan se mahdollistaa myös offline-ominaisuuksien kehittämisen. Vaikka paikallinen tallennustila on turvallinen ja käytännöllinen, on tärkeää muistaa, että se ei ole tarkoitettu suurille tietomäärille, koska sen koko on rajoitettu. Paikallista tallennustilaa kannattaa käyttää vain, jos tiedot ovat suhteellisen pieniä ja niiden ei tarvitse olla täysin turvallisia, koska tallennustila ei ole salattu.

Miten luoda ja hallita asiakaslistoja .NET MAUI:lla?

Asiakaslistojen ja yksittäisten asiakastietojen hallinta on keskeinen osa monien sovellusten toimintaa, erityisesti kun käsitellään suuria tietomääriä. .NET MAUI (Multi-platform App UI) tarjoaa tehokkaita työkaluja, joiden avulla voidaan luoda dynaamisia ja käyttäjäystävällisiä sovelluksia niin mobiili- kuin työpöytäkoneillekin. Tämä luku keskittyy asiakkaiden esittämiseen ja muokkaamiseen, käyttäen .NET MAUI:n tarjoamia komponenteja, kuten ObservableCollection ja ListView, ja käydään läpi vaihe vaiheelta, kuinka asiakaslistoja voidaan hallita ja näyttää.

Asiakaslistan luominen ja hallinta

Ensimmäinen askel asiakaslistan luomisessa on tarvittavan tietomallin määrittäminen. Esimerkiksi CustomerDetailViewModel-luokka, joka sisältää asiakastiedot, kuten asiakas-ID:n, yrityksen nimen, yhteyshenkilön nimen, kaupungin, maan ja puhelinnumeron, toimii datan säilyttäjänä ja välittäjänä käyttöliittymän ja palveluiden välillä.

Tietojen näyttäminen ja päivittäminen sovelluksessa tapahtuu ObservableCollection-luokan avulla, joka on erityisesti suunniteltu tukemaan dynaamisia tietojoukkoja. Tämä luokka mahdollistaa sen, että kaikki sen sisällä olevat tiedot voivat ilmoittaa käyttöliittymälle muutoksista, kuten uusien tietojen lisäämisestä, poistamisesta tai päivityksistä. Tämä on erittäin tärkeää dynaamisessa sovelluksessa, jossa käyttäjät voivat jatkuvasti muokata tai lisätä tietoja ilman, että käyttöliittymän täytyy olla statinen.

csharp
Copy code
public void AddSampleData(bool clearList = true) {
    if (clearList) Clear();
    Add(new CustomerDetailViewModel { 
        CustomerId = "ALFKI", 
        CompanyName = "Alfreds Futterkiste", 
        ContactName = "Maria Anders", 
        City = "Berlin", 
        Country = "Germany", 
        Phone = "030-0074321" 
    });
    Add(new CustomerDetailViewModel { 
        CustomerId = "FRANK", 
        CompanyName = "Frankenversand", 
        ContactName = "Peter Franken", 
        City = "München", 
        Country = "Germany", 
        Phone = "089-0877310" 
    });
    Add(new CustomerDetailViewModel { 
        CustomerId = "SEVES", 
        CompanyName = "Seven Seas Imports", 
        ContactName = "Hari Kumar", 
        City = "London", 
        Country = "UK", 
        Phone = "(171) 555-1717" 
    });
}

Tämä koodi varmistaa, että listalle lisätään aina testiasiakkaita, jos clearList on asetettu arvoksi true.

Asiakkaiden listaaminen ja yksityiskohtien näyttäminen

Lisäksi käyttöliittymässä voi olla toimintoja, kuten asiakastietojen muokkaaminen ja lisääminen. Näiden toimintojen avulla käyttäjä voi navigoida yksittäisten asiakkaiden yksityiskohtiin tai lisätä uusia asiakkaita listalle. Esimerkiksi seuraavat tapahtumankäsittelijät on määritelty:

• Customer_Tapped: Tapahtuma, joka käynnistyy, kun käyttäjä napauttaa asiakasta listassa. Tämä ohjaa käyttäjän yksityiskohtaiselle asiakasnäkymälle.

• Customers_Refreshing: Tapahtuma, joka aktivoituu, kun käyttäjä haluaa päivittää asiakaslistan.

• Customer_Deleted: Tapahtuma, joka poistaa asiakaslistalta valitun asiakkaan.

• Customer_Phoned: Tapahtuma, joka avaa puhelinsovelluksen ja soittaa asiakkaan puhelinnumeroon.

Näiden tapahtumien avulla luodaan käyttäjäystävällinen ja interaktiivinen kokemus, jossa käyttäjä voi helposti hallita asiakaslistaa ja yksittäisiä asiakkaita.

csharp
Copy code
async void Customer_Tapped(object sender, ItemTappedEventArgs e) {

    if (e.Item is not CustomerDetailViewModel c) return;
    await Navigation.PushAsync(new CustomerDetailPage(BindingContext as CustomersListViewModel, c));
}

Asiakastietojen tarkastelu ja muokkaaminen

Kun käyttäjä muokkaa asiakastietoja ja tallentaa muutokset, tiedot päivittyvät suoraan ObservableCollection-luokassa olevaan asiakaslistaan. Tässä yhteydessä on tärkeää muistaa, että tiedot päivittyvät vain silloin, kun ne on oikein sidottu näkymän malliin ja tapahtumankäsittelijät on oikein määritelty.

csharp
Copy code
async void Add_Clicked(object sender, EventArgs e) {

    await Navigation.PushAsync(new CustomerDetailPage(BindingContext as CustomersListViewModel));
}

Tärkeää huomioida

Kun suunnittelee ja toteuttaa asiakaslistoja ja -tietojen hallintaa .NET MAUI:ssa, on tärkeää muistaa, että tietojen dynaaminen päivitys ja käyttöliittymän reagointi muutoksiin ovat keskeisiä tekijöitä käyttäjäkokemuksen kannalta. ObservableCollection tarjoaa kätevän tavan hallita tällaisia päivityksiä, mutta se vaatii huolellista datan hallintaa ja oikeiden tapahtumien käsittelyä.

Mikä tekee kyselytyökaluista tehokkaita ja miten niiden kehittäminen onnistuu?

Kysely- ja äänestystyökalujen markkina on monipuolinen ja elinvoimainen, tarjoten ratkaisuja aina suurista toimijoista, kuten Optimizely ja Adobe, SaaS-pohjaisiin palveluihin kuten SquareSpace, sekä avoimen lähdekoodin vaihtoehtoihin kuten Piranha ja Umbraco. Näiden työkalujen perimmäisenä tarkoituksena on kerätä tietoa käyttäjiltä tehokkaasti ja analysoida sitä päätöksenteon tukemiseksi. Suosituimpia kyselyalustoja ovat esimerkiksi SurveyMonkey, Google Forms ja Microsoft Forms, mutta markkinoilla on useita muita vaihtoehtoja, joista valita käyttötarkoituksen ja budjetin mukaan.

Useimmat kyselytyökalut tarjoavat ilmaisen perusversion, joka mahdollistaa työkalun kokeilun, mutta usein käyttö laajenee maksullisiin tilauksiin, joissa on enemmän ominaisuuksia ja suurempi kapasiteetti vastauksille. Esimerkiksi SurveyMonkeyn ilmaisessa versiossa kyselyssä voi olla enintään 10 kysymystä ja 40 vastausta, eikä vastauksia voi viedä ulos analysointia varten. Tämän vuoksi moni kehittäjä tai organisaatio päätyy luomaan oman kyselyratkaisunsa, joka vastaa tarkemmin heidän tarpeitaan ja mahdollistaa joustavamman käytön ilman suuria kustannuksia.

Kyselyiden kysymystyypit vaihtelevat yksinkertaisista monivalintakysymyksistä aina monimutkaisempiin, kuten asteikkoihin, matriiseihin ja vapaamuotoisiin tekstivastauksiin. Kyselytyökalujen kehityksessä on tärkeää huomioida, kuinka helppoa tai haastavaa erilaisten kysymystyyppien toteuttaminen on. Perustyyppien, kuten yksirivisen tekstikentän tai yhden vaihtoehdon valinnan toteuttaminen on suoraviivaista, kun taas esimerkiksi monitasoiset matriisit tai kuvapohjaiset valinnat vaativat monimutkaisempaa suunnittelua ja teknistä toteutusta.

Äänestykset ja visailut muistuttavat kyselyjä, mutta niissä on omat erityispiirteensä. Live-äänestyksissä tärkeää on reagointiajan lyhyys ja vastauksien reaaliaikainen kerääminen, kun taas visailuissa on olennaista oikeiden vastausten määrittely ja pisteytysjärjestelmä. Näiden sovellusten käyttö esimerkiksi webinaareissa tai koulutuksissa mahdollistaa osallistujien aktiivisen sitouttamisen ja palautteen keräämisen reaaliaikaisesti, mikä tukee oppimiskokemusta ja vuorovaikutusta.

Vastausten analysointi on toinen keskeinen ominaisuus. Perinteiset analyysityökalut tarjoavat kaavioita ja taulukoita, mutta kehittyneemmät järjestelmät voivat hyödyntää koneoppimista ja tekoälyä löytääkseen poikkeavuuksia ja malleja suurista vastausaineistoista. Analyysin tarkoituksena on tiivistää suuri määrä dataa ymmärrettävään muotoon ja tarjota käyttäjälle selkeä kokonaiskuva tutkimuskohteesta.

Tuotteen vaatimusten määrittely on kyselytyökalun kehittämisen perusta. Minimalistinen versio (MVP) sisältää yleensä verkkosivun, jolla kyselyyn voi vastata anonyymisti, sovelluksen vastausten tarkasteluun, tietovarastoinnin kysymys- ja vastausdatalle sekä palvelut näiden toiminnallisuuksien yhdistämiseksi. Verkkosivun on oltava saavutettavissa mahdollisimman monelta laitteelta ilman kirjautumista, ja kyselyn tekemisen tulisi olla vaivatonta ilman rajoituksia esimerkiksi vastauskertojen määrässä.

Laajennetuissa versioissa käyttäjät voivat rekisteröityä ja hallita profiilitietojaan, mikä mahdollistaa esimerkiksi kyselyiden seurantaa ja yksilöllisempää tiedonkeruuta. Kysymystyypit laajenevat monimuotoisiksi sisältäen rikkaan tekstin, kuvapohjaiset valinnat ja erilaiset arviointimenetelmät. Analyysityökalut voivat tarjota useita näkymiä ja tapoja tulosten tulkintaan.

On tärkeää muistaa, että kyselytyökalu ei ole pelkkä tekninen ratkaisu, vaan se on osa laajempaa kommunikaatio- ja tiedonkeruustrategiaa. Kysymysten suunnittelu, kohderyhmän huomioiminen ja analyysin tavoitteiden selkeys vaikuttavat ratkaisevasti siihen, kuinka luotettavaa ja käyttökelpoista kerätty data on. Lisäksi kyselyiden saavutettavuus ja käyttäjäystävällisyys varmistavat, että vastaajamäärä ja -laatu pysyvät korkealla tasolla.

Miten lisätä tuote GraphQL:n avulla?

GraphQL on tehokas ja joustava kyselykieli, jonka avulla voidaan yhdistää useita tietolähteitä ja suorittaa monimutkaisempia toimintoja kuin perinteiset REST-rajapinnat. Tämä mahdollistaa muun muassa tietojen muuttamisen (mutations) dynaamisesti ilman tarvetta erillisiin HTTP-pyynnöihin.

Kuvitellaan, että käytämme GraphQL-palvelua, jonka avulla voidaan suorittaa tuotehakuja, lisätä uusia tuotteita ja muokata olemassa olevia. Ensimmäiseksi on luotava syötteen malli (AddProductInput), joka määrittää tuotteen tiedot, kuten nimen, hinnan, varastomäärät ja mahdolliset lisäominaisuudet kuten kategoria ja toimittaja.

csharp
Copy code
public record AddProductInput(

    string ProductName, 
    int? SupplierId, 
    int? CategoryId, 
    string QuantityPerUnit, 
    decimal? UnitPrice, 
    short? UnitsInStock, 
    short? UnitsOnOrder, 
    short? ReorderLevel, 
    bool Discontinued);

Tässä koodissa määritellään "AddProductInput"-tieto-olio, jossa on kaikki tarpeelliset kentät tuotteen lisäämistä varten. Kenttien tyypit ovat mukautettavissa, ja useat niistä ovat valinnaisia (esimerkiksi SupplierId ja CategoryId voivat olla tyhjiä). Näin ollen tämä malli tarjoaa joustavan tavan käsitellä tuotetietoja.

Kun tietomalli on luotu, seuraavaksi määritellään itse muutosoperaatio, joka vastaanottaa tämän syötteen ja suorittaa tuotteen lisäämisen tietokantaan.

csharp
Copy code
public class Mutation {

    public async Task<AddProductPayload> AddProductAsync(
        AddProductInput input, NorthwindContext db) {
        Product product = new() {
            ProductName = input.ProductName,
            SupplierId = input.SupplierId,
            CategoryId = input.CategoryId,
            QuantityPerUnit = input.QuantityPerUnit,
            UnitPrice = input.UnitPrice,
            UnitsInStock = input.UnitsInStock,
            UnitsOnOrder = input.UnitsOnOrder,
            ReorderLevel = input.ReorderLevel,
            Discontinued = input.Discontinued
        };
        db.Products.Add(product);
        int affectedRows = await db.SaveChangesAsync();
        return new AddProductPayload(product);
    }
}

Mutta pelkkä koodin kirjoittaminen ei riitä. Kun olemme määrittäneet GraphQL-mutaation, seuraavaksi meidän on rekisteröitävä se palveluun. Tämä tehdään yleensä Program.cs-tiedostossa, jossa palvelu alustetaan ja GraphQL-kyselyt sekä mutaatiot rekisteröidään.

csharp
Copy code
builder.Services
    .AddGraphQLServer()
    .RegisterDbContext()
    .AddQueryType()
    .AddMutationType();

graphql
Copy code
type Mutation {
    addProduct(input: AddProductInput!): AddProductPayload!
}

Kun tämä on määritelty, voimme käyttää GraphQL-kyselyä uuden tuotteen lisäämiseksi. Esimerkiksi lisäämme "Tasty Burgers" -nimisen tuotteen seuraavalla kyselyllä:

graphql
Copy code
mutation AddProduct {

    addProduct(input: {
        productName: "Tasty Burgers"
        supplierId: 1
        categoryId: 2
        quantityPerUnit: "6 per box"
        unitPrice: 40
        unitsInStock: 0
        unitsOnOrder: 0
        reorderLevel: 0
        discontinued: false
    }) {
        product {
            productId
            productName
        }
    }
}

Tässä esimerkissä addProduct-kysely lisää tuotteen tietokantaan, ja kysely palauttaa tuotteen tiedot, kuten tuotteen ID ja nimi. Tämä on tehokas tapa luoda ja päivittää tietoja käyttämällä GraphQL:ää.

On tärkeää huomioida, että GraphQL:n käyttäminen ei rajoitu pelkästään tietojen hakemiseen ja muokkaamiseen. GraphQL tarjoaa myös mahdollisuuden yhdistää useita tietolähteitä ja suorittaa monimutkaisempia toimenpiteitä yhdellä kyselyllä. Esimerkiksi voidaan yhdistää tuotteet ja niiden toimittajat, kategoriat tai tilauskohtaiset tiedot yhdellä GraphQL-kyselyllä, mikä tekee sovelluksista tehokkaampia ja joustavampia.