Ft page iterator #13

[jobala]

Overview

Adds PageIterator

Demo

Create a page iterator task

pageIterator, err := msgraphgocore.NewPageIterator(graphResponse, *reqAdapter, ParsableCons)
pageIterator.SetHeaders(map[string]string{"Content-Type": "application/json"})

Iterate

err := pageIterator.Iterate(func(pageItem interface{}) bool {
      item := pageItem.(graph.User)
      res = append(res, *item.GetId())
      return true
})

Pause & Resume

pageIterator.Iterate(func(pageItem interface{}) bool {
      item := pageItem.(graph.User)
      res = append(res, *item.GetId())
      
      return *item.GetId() != "2" // pauses when id == 2
})

// resumes iteration from user with id 3
pageIterator.Iterate(func(pageItem interface{}) bool {
      item := pageItem.(graph.User)
      res2 = append(res2, *item.GetId())
      
      return true
})

Notes

• I made the Next & HasNext methods private because we have not reached a consensus on making them part of the Iterator's API

Testing

• Run go test

Closes #13

[baywet]

good first draft, added a few comments.

[baywet]

almost there! some minor changes. Don't hesitate to switch the PR to ready whenever it's ready.

[baywet]

also CC @jasonjoh for the public docs update of this page

@jobala can you update the snippets in your initial comment with the latest changes so Jason has visibility please?

[baywet]

thanks for making the changes! only two docs comments missing and we should be good to go.
I also configured sonarcloud to exclude internal package from the metrics so it reflects the actual coverage.

[baywet]

Also please update the changelog https://github.com/microsoftgraph/msgraph-sdk-go-core/blob/main/CHANGELOG.md

[sonarcloud]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
0 Code Smells

82.6% Coverage
0.0% Duplication

[baywet]

thanks for the excellent work!