CRUD — Leia — Swift SDK

Leia as características

Quando você projeta os padrões de acesso a dados da sua aplicação em torno das três principais características de leituras a seguir no Realm, você pode ter certeza de que está lendo dados da forma mais eficiente possível.

Limitando resultados da consulta

Como resultado da avaliação preguiçosa, você não precisa de nenhum mecanismo especial para limitar os resultados da consulta com o Realm. Por exemplo, se a sua consulta corresponder a milhares de objetos, mas você quiser carregar somente os dez primeiros, basta acessar somente os dez primeiros elementos da collection de resultados.

Paginação

Graças à avaliação preguiçosa, a tarefa comum da paginação se torna bastante simples. Por exemplo, suponha que você tenha uma coleção de resultados associada a uma consulta que corresponda a milhares de objetos em seu domínio. Você exibe cem objetos por página. Para avançar para qualquer página, basta acessar os elementos da coleta de resultados começando pelo índice que corresponde à página de destino.

Sobre os exemplos nesta página

Os exemplos nesta página usam os seguintes modelos:

Encontrar um objeto específico por chave primária

Consultar todos os objetos de dado específico

Filtrar consultas com base nas propriedades do objeto

Um filtro seleciona um subconjunto de resultados com base no(s) valor(es) de uma ou mais propriedades do objeto. O Realm oferece um mecanismo de consulta completo que você pode usar para definir filtros.

Filtro sobre Propriedades de ID de objeto

Os tipos no seu predicado devem corresponder aos tipos das propriedades. Evite comparar propriedades de ObjectID com cadeias de caracteres, pois o Realm não converte automaticamente cadeias de caracteres em ObjectIDs.

Fazer query em um relacionamento

Você pode fazer consultas por meio de um relacionamento da mesma forma que acessaria um nó de um objeto regular do Swift ou Objective-C.

Consultar um Relacionamento Inverso

Você pode fazer consultas por meio de um relacionamento inverso da mesma forma que acessaria um nó de um objeto regular do Swift ou Objective-C.

Consultar uma Coleção sobre Propriedades de Objetos Embarcados

Use a notação de ponto para filtrar ou classificar uma coleção de objetos com base em um valor de propriedade de objeto incorporado:

Consultar uma Propriedade de Mapa

Você pode iterar e verificar os valores de um mapa Realm como faria com um Dicionário:

let realm = try! Realm()
let dogs = realm.objects(Dog.self)
// Find dogs who have favorite parks
let dogsWithFavoriteParks = dogs.where {
    $0.favoriteParksByCity.count >= 1
}
for dog in dogsWithFavoriteParks {
    // Check if an entry exists
    if dog.favoriteParksByCity.keys.contains("Chicago") {
        print("\(dog.name) has a favorite park in Chicago")
    }
    // Iterate over entries
    for element in dog.favoriteParksByCity {
        print("\(dog.name)'s favorite park in \(element.key) is \(element.value)")
    }
}

Fazer query em uma propriedade MutableSet

Você pode consultar um MutableSet para verificar se ele contém um elemento. Se você estiver trabalhando com vários conjuntos, poderá verificar a interseção de dois conjuntos ou verificar se um conjunto é um subconjunto do outro.

let realm = try! Realm()
// Find dogs who have visited New York
let newYorkDogs = realm.objects(Dog.self).where {
    $0.citiesVisited.contains("New York")
}
// Get some information about the cities they have visited
for dog in newYorkDogs {
    print("Cities \(dog.name) has visited: \(dog.citiesVisited)")
}
// Check whether two dogs have visited some of the same cities.
// Use "intersects" to find out whether the values of the two sets share common elements.
let isInBothCitiesVisited = (dog.citiesVisited.intersects(dog2.citiesVisited))
print("The two dogs have visited some of the same cities: \(isInBothCitiesVisited)")
// Prints "The two dogs have visited some of the same cities: true"
// Or you can check whether a set is a subset of another set. In this example,
// the first dog has visited "New York" and "Toronto", while dog2 has visited both of
// those but also "Toronto" and "Boston".
let isSubset = (dog.citiesVisited.isSubset(of: dog2.citiesVisited))
print("\(dog.name)'s set of cities visited is a subset of \(dog2.name)'s: \(isSubset)")
// Prints "Maui's set of cities visited is a subset of Lita's: true"

Ler e Consultar Propriedade AnyRealmValue

Ao ler uma propriedade AnyRealmValue, verifique o tipo do valor antes de fazer qualquer coisa com ele. O Realm Swift SDK fornece um enum AnyRealmValue que itera por todos os tipos que o AnyRealmValue pode armazenar.

let realm = try! Realm()
let dogs = realm.objects(Dog.self)
for dog in dogs {
    // Verify the type of the ``AnyRealmProperty`` when attempting to get it. This
    // returns an object whose property contains the matched type.
    // If you only care about one type, check for that type.
    if case let .string(companion) = dog.companion {
        print("\(dog.name)'s companion is: \(companion)")
        // Prints "Wolfie's companion is: Fluffy the Cat"
    }
    // Or if you want to do something with multiple types of data
    // that could be in the value, switch on the type.
    switch dog.companion {
    case .string:
        print("\(dog.name)'s companion is: \(dog.companion)")
        // Prints "Wolfie's companion is: string("Fluffy the Cat")
    case .object:
        print("\(dog.name)'s companion is: \(dog.companion)")
        // Prints "Fido's companion is: object(Dog { name = Spot })"
    case .none:
        print("\(dog.name) has no companion")
        // Prints "Rex has no companion" and "Spot has no companion"
    default:
        print("\(dog.name)'s companion is another type.")
    }
}

Você pode comparar esses tipos de valores mistos:

• Numérico: int, bool, float, duplo, decimal

• Baseado em bytes: string, binário

• Baseado em tempo: carimbo de data/hora, objectId

Ao usar o tipo de dados misto AnyRealmValue, lembre-se do seguinte:

• equals consultas fazem a correspondência de valor e tipo

• not equals consultas fazem a correspondência de objetos com valores ou tipos diferentes

• realm converte propriedades numéricas comparáveis sempre que possível. Por exemplo, em um campo de tipo misto, 1 corresponde a todos 1.0, 1 e verdadeiro.

• As propriedades de string não correspondem a consultas numéricas. Por exemplo, em um campo de tipo misto, 1 não corresponde a "1". "1" não corresponde a 1, 1.0 ou verdadeiro.

Executar query de dados geoespaciais

O Swift SDK fornece diversas formas para simplificar a query de dados geospaciais. Você pode usar as formas GeoCircle, GeoBox e GeoPolygon para definir os limites de suas queries de dados geoespaciais.

O SDK fornece dois tipos de dados especializados não persistentes para definir formas:

• GeoPoint: uma estrutura que representa as coordenadas de uma ponta formada por um par de duplos contendo estes valores:

  • Latitude: varia entre -90 e 90 graus, inclusivo.

  • Longitude: varia entre -180 e 180 graus, inclusivo.

• RLMDistance: uma estrutura auxiliar para representar e converter uma distância.

Executar query com formas geoespaciais

Você pode usar estas formas em uma query geoespacial. Você pode executar uma query de dados geoespaciais de três maneiras:

• Usar o operador .geoWithin() com a API Realm Swift Query com segurança de tipo

• Usar um .filter() com RQL

• Usar um .filter() com uma query NSPredicate

Os exemplos abaixo mostram os resultados das queries usando estes dois objetos Company:

let company1 = Geospatial_Company()
company1.location = CustomGeoPoint(47.68, -122.35)
let company2 = Geospatial_Company(CustomGeoPoint(47.9, -121.85))

clique para ampliar

Fazer query em uma propriedade persistente personalizada

Quando você usa a projeção de tipo para mapear tipos sem suporte para tipos com suporte, o acesso a essas propriedades geralmente é baseado no tipo persistente.

let akcClub = realm.objects(Club.self).where {
    $0.name == "American Kennel Club"
}.first!
// You can use type-safe expressions to check for equality
XCTAssert(akcClub.url == URL(string: "https://akc.org")!)
let clubs = realm.objects(Club.self)
// You can use the persisted property type in NSPredicate query expressions
let akcByUrl = clubs.filter("url == 'https://akc.org'").first!
XCTAssert(akcByUrl.name == "American Kennel Club")