• Stars
    star
    854
  • Rank 53,015 (Top 2 %)
  • Language
    C#
  • License
    Other
  • Created over 9 years ago
  • Updated 3 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

OData Web API: A server library built upon ODataLib and WebApi

OData Web API

Build Status
Odata.WebApi Rolling Dotnet pipeline
WebApi Rolling
WebApi Nightly

Introduction

OData Web API (i.e., ASP.NET Web API OData) is a server library built upon ODataLib and Web API.

Project structure

The project currently has the following branches:

master branch

This is the active development branch for OData WebApi and it is currently most actively iterated. The package name is Microsoft.AspNet.OData. The is the OData WebApi for ODL v7.x releases which contain breaking changes against ODL v6.

release branch

This is the release branch for OData WebApi, contains code base up to most recently stable WebApi release. The latest release version is 6.0.

feature/netcore branch

This is the feature development branch for OData WebApi for AspNet and AspNetCore. The package names are Microsoft.AspNet.OData and Microsoft.AspNetCore.OData. The is the OData WebApi 7.0 release which contain breaking changes against OData WebApi 6.0.

gh-pages branch

The gh-pages branch contains the old documentation source for OData WebApi - tutorials, guides, etc. For the most up-to-date documentation you should use Microsoft docs.

maintenance-aspnetcore branch

This is the maintenance branch for OData WebApi with ASP.NET Core support. The package name is Microsoft.AspNetCore.OData.

maintenance-V4 branch

This is the maintenance branch for OData WebApi based on ODL 6.x, which implements the ODataV4 protocol. The package name is Microsoft.AspNet.OData, with latest maintenance release version 5.10.

maintenance-V3 branch

This is the maintenance branch for OData WebApi based on ODL 5.x, which implements the ODataV3 protocol. The package name is Microsoft.AspNet.WebApi.OData, with latest maintenance release version 5.7.

maintenance-dnx branch

This is maintenance branch for an early prototype version of OData WebApi based on original ASP.NET Core, aka DNX. Package name is Microsoft.AspNet.OData. This is for project archive purpose only, is not active and doesn't accept contributions. It has only one release.

odata-v5.3-rtm v2.0-rtm v3-rtm v3.1-rtm v3.2-rtm branches

These are maintenance branches for previous RTMs. Project archives only, contributions not accepted.

Building

build.cmd

Testing

Each solution contains some test projects. Test projects use xUnit runner nuget package.

Tests will not run correctly unless SkipStrongNames is Enabled. Please run

build.cmd EnableSkipStrongNames

Run tests in cmd

To run end-to-end tests, you need to open an elevated - Run as administrator - command prompt

  • build.cmd build projects, run unit tests, and OData end-to-end tests.

  • build.cmd quick build project, and run unit tests

To disable the SkipStrongNames:

build.cmd DisableSkipStrongNames

Run tests in Visual Studio

Open the project, build it, and then test cases should appear in test explorer. If not, this is because the assemblies are delay signed and you're missing the private key so xunit will not load them in Visual Studio. To fix, please run build.cmd EnableSkipStrongNames. Run all the tests in the test explorer. For running end-to-end tests you must open the solution as Administrator. More detail at this.

Nightly builds

The nightly build process will upload a NuGet packages for WebApi to: v7.x.x: MyGet.org webapinetcore feed v6.x.x: MyGet.org webapinightly feed

To connect to webapinightly feed, use this feed URL: v7.x.x: webapinetcore MyGet feed URL v6.x.x: webapinightly MyGet feed URL

You can query the latest nightly NuGet packages using this query: v7.x.x: MAGIC WebApi query v6.x.x: MAGIC WebApi query

Contribution

Please refer to the CONTRIBUTION.md.

Reporting Security Issues

Security issues and bugs should be reported privately, via email, to the Microsoft Security Response Center (MSRC) [email protected]. You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Further information, including the MSRC PGP key, can be found in the Security TechCenter. You can also find these instructions in this repo's SECURITY.md.

Documentation

Please visit the OData Web API pages.

Samples

Please refer to the ODataSamples Repro.

  • ASP.NET Core OData samples at here
  • ASP.NET Classic OData samples at here

Debug

Please refer to the How to debug.

Code of Conduct

This project has adopted the .NET Foundation Contributor Covenant Code of Conduct. For more information see the Code of Conduct FAQ.

.NET Foundation

This project is supported by the .NET Foundation.

WebApi is a Copyright of ยฉ .NET Foundation and other contributors. It is licensed under MIT License

More Repositories

1

odata.net

ODataLib: Open Data Protocol - .NET Libraries and Frameworks
C#
677
star
2

RESTier

A turn-key library for building RESTful services
C#
468
star
3

AspNetCoreOData

ASP.NET Core OData: A server library built upon ODataLib and ASP.NET Core
C#
358
star
4

ODataSamples

Samples: For ODataLib, OData Web API, RESTier, etc.
C#
290
star
5

OData.Neo

C#
108
star
6

odatapy-client

OData Python client
C++
89
star
7

ODataConnectedService

A Visual Studio extension for generating client code for OData Services
C#
70
star
8

OData4ObjC

OData client for iOS.
Objective-C
69
star
9

odataorg.github.io

Staging site and collaboration repository for http://www.odata.org
HTML
60
star
10

lab

This repository is for exploring new ideas and developing early prototypes of various OData stacks.
C#
48
star
11

odatacpp-client

OData C++ Client Libraries
C++
44
star
12

odatacpp-server

OData C++ Server Libraries
C++
32
star
13

model-first

Model-first tooling
JavaScript
28
star
14

ModelBuilder

A project to generate Edm (Entity Data Model) from CLR types
C#
19
star
15

ValidationTool

Enable OData service authors ensure that their service interoperates well with any OData client.
C#
19
star
16

odata.github.io

Documentation source of Microsoft OData stack.
CSS
12
star
17

vocabularies

OData vocabulary definitions and usage
11
star
18

v3ProtocolDocument

Short-lived project to collaboratively edit the OData v3 protocol document.
Shell
11
star
19

Extensions

ExtensionsLib: - Extensions for OData libraries and framework
C#
10
star
20

WebApiAuthorization

C#
9
star
21

RequestBuilder

REST Request builder for OData services
5
star
22

Home

This is the Home repository for discussion, design spec, feedback, Q&A of OData related.
1
star
23

OData4Soda

OData service that translates calls into calls against an underlying SODA service.
1
star