Conas a dhéanann tú leathanú in GraphQL: offset i gcomparáid le cursor?

Question

IT Interview Practice · Accepted Answer

Dhá straitéis: **bunaithe ar offset** (`limit`/`offset`) agus **bunaithe ar cursor**. Níl aon leathanú ionsuite ag GraphQL, ach is é an caighdeán pobail ná an tsonraíocht **Relay Connection**, a fhoirmiúlaíonn leathanú cursor.

## Offset i gcomparáid le cursor

- Tá **Offset** (`items(limit: 10, offset: 20)`) simplí ach briseann sé ar shonraí beo: má chuirtear ró isteach agus an t-úsáideoir ag leathanú, aistríonn míreanna agus feiceann tú dúbailtí nó bearnaí. Éiríonn sé mall freisin ag offsets doimhne (scanann an DB na rónna a scipeáiltear fós).
- Díríonn **Cursor** ar shuíomh cobhsaí ("tabhair dom 10 tar éis na míre seo"). Tá sé slán ó thaobh ionsáite de agus scálaíonn sé go leathanaigh dhoimhne, ar an gcostas nach féidir "léim go leathanach 50" go randamach.

## Naisc Relay

Fillleann nasc an liosta in `edges` (gach ceann le `cursor` agus `node`) chomh maith le `pageInfo`:

```graphql
type Query {
  posts(first: Int!, after: String): PostConnection!   # first = page size, after = cursor
}

type PostConnection {
  edges: [PostEdge!]!
  pageInfo: PageInfo!
}
type PostEdge {
  cursor: String!        # opaque token for THIS node's position
  node: Post!            # the actual item
}
type PageInfo {
  endCursor: String      # feed this back as 'after' for the next page
  hasNextPage: Boolean!  # so the client knows when to stop
}
```

```js
// resolver: fetch ONE extra row to compute hasNextPage cheaply
const rows = await db.posts.find({ after: args.after, limit: args.first + 1 });
const hasNextPage = rows.length > args.first;
const page = rows.slice(0, args.first);
return {
  edges: page.map((p) => ({ node: p, cursor: encodeCursor(p.id) })),
  pageInfo: { endCursor: page.at(-1) && encodeCursor(page.at(-1).id), hasNextPage },
};
```

Tá an cursor **teimhneach** — de ghnáth base64 den eochair shórtála — agus mar sin caitheann cliaint leis mar token, ní mar uimhir.

## Cén fáth a bhfuil sé tábhachtach

Léiríonn roghnú offset i gcomparáid le cursor go dtuigeann tú **comhsheasmhacht faoi scríbhinní comhuaineacha** agus **feidhmíocht leathanach doimhin**. Tá tábhacht le heolas ar chruth an naisc Relay toisc go bhfuil láimhseáil taisce ionsuite ag cliaint Apollo/Relay dó.

Offset i gcomparáid le cursor

Naisc Relay

Cén fáth a bhfuil sé tábhachtach

Ceisteanna gaolmhara