What's the term for re-implementing an old API in terms of a newer API

Posted by dodgy_coder on Programmers See other posts from Programmers or by dodgy_coder
Published on 2012-06-20T02:32:02Z Indexed on 2012/06/20 3:23 UTC
Read the original article Hit count: 471

Filed under:

terminology

|

api-design

|

backward-compatibility

The reason for doing it is to solve the case when a newer API is no longer backwards compatible with an older API.

To explain, just say that there is an old API v1.0. The maker of this API decides it is broken and works on a new API v1.1 that intentionally breaks compatibility with the old API v1.0. Now, any programs written against the old API cannot be recompiled as-is with the new API.

Then lets say there is a large app written against the old API and the developer doesn't have access to the source code. A solution would be to re-implement a "custom" old API v1.0 in terms of the new API v1.1 calls. So the "custom" v1.0 API is actually keeping the same interface/methods as the v1.0 API but inside its implementation it is actually making calls to the new API v1.1 methods.

So the large app can be then compiled and linked against the "custom" v1.0 API and the new v1.1 API without any major source code changes.

Is there a term for this practice?

There's a recent example of this happening in Jamie Zawinski's port of XScreenSaver to the iPhone - he re-implemented the OpenGL 1.3 API in terms of the OpenGL ES 1.1 API. In this case, OpenGL 1.3 represents the "old" API and OpenGL ES 1.1 represents the "new" API.

© Programmers or respective owner

Related posts about terminology

Terminology for web app running on hardware

as seen on Stack Overflow - Search for 'Stack Overflow'
Hi, Let me start by saying I feel very silly asking this, hence the newbie tag. I am trying to investigate how to develop an UI application that will run directly on hardware. This will be very much like when you access the web based application within your router. I don't really know how what… >>> More
Is there tool agnostic terminology for source control activities?

as seen on Programmers - Search for 'Programmers'
My team is entering into some discussions on source control (process and possibly tools) and we would like a tool agnostic terminology for the various activities. The environment does have multiple (old) VCS's, and multiple desired (new) VCS's. Is there a standard definition of activities, or at least… >>> More
Claims-based Identity Terminology

as seen on Geeks with Blogs - Search for 'Geeks with Blogs'
There are several terms commonly used to describe claims-based identity, and it is important to clearly define these terms. · Identity In terms of Access Control, the term identity will be used to refer to a set of claims made by a trusted issuer about the user. · Claim You can think of a claim… >>> More
What is a "wrapper" program?

as seen on Programmers - Search for 'Programmers'
Where I work, employees use a third-party desktop program for their clients. This program saves data to a flat file. My colleague wants to write a Java program that uploads that flat file to a remote server, opens the desktop program when the flat file is downloaded from a Web site, and checks if… >>> More
How do you portray to non programmers what programming involves?

as seen on Programmers - Search for 'Programmers'
I get casually asked a lot to take a couple days to teach someone how to program. Most people really think they can learn what I know in a few days. When I tell them I have been doing this for many years and I can't teach them to be a programmer in a few days, they look at me like I am being a jerk… >>> More

Related posts about api-design

Google I/O 2010 - Google Wave API design principles

as seen on Google Code - Search for 'Google Code'
Google I/O 2010 - Google Wave API design principles Google I/O 2010 - Google Wave API design principles + anatomy of a great extension Wave 201 Pamela Fox, Michael Goderbauer (Hasso Plattner Institute) Google Wave is all about collaboration. The most successful extensions are user-friendly and collaborative… >>> More
REST api design to retrieve summary information

as seen on Stack Overflow - Search for 'Stack Overflow'
I have a scenario in which I have REST API which manages a Resource which we will call Group. A Group is similar in concept to a discussion forum in Google Groups. Now I have two GET access method which I believe needs separate representations. The 1st GET access method retrieves the minimal amount… >>> More
Books about Javascript API design best practices

as seen on Stack Overflow - Search for 'Stack Overflow'
Hi, Anyone can suggest good books about Javascript API design good practices? What are the common practices developed by Google, Twitter, Facebook in their APIs. Code organization, request control etc. >>> More
Should one always know what an API is doing just by looking at the code?

as seen on Programmers - Search for 'Programmers'
Recently I have been developing my own API and with that invested interest in API design I have been keenly interested how I can improve my API design. One aspect that has come up a couple times is (not by users of my API but in my observing discussion about the topic): one should know just by looking… >>> More
Objective-C wrapper API design methodology

as seen on Stack Overflow - Search for 'Stack Overflow'
I know there's no one answer to this question, but I'd like to get people's thoughts on how they would approach the situation. I'm writing an Objective-C wrapper to a C library. My goals are: 1) The wrapper use Objective-C objects. For example, if the C API defines a parameter such as char *name… >>> More