Программный интерфейс - История изменений

Nachinka: /* Реализация клиента */

2017-02-01T01:38:17Z

Реализация клиента

← Предыдущая		Версия 11:38, 1 февраля 2017
Строка 216:		Строка 216:
	pCalc = dlllib.GetObject()		pCalc = dlllib.GetObject()

	~~#print( 'Calc address in python {:#x}'.format(pCalc))~~
	calc = ctypes.cast (pCalc, ctypes.POINTER(ICalculator))		calc = ctypes.cast (pCalc, ctypes.POINTER(ICalculator))
			#ctypes.WINFUNCTYPE for stdcall, ctypes.CFUNCTYPE for cdecl
	add_prototype = ctypes.WINFUNCTYPE(ctypes.c_int, ctypes.c_void_p, ctypes.c_int, ctypes.c_int)		add_prototype = ctypes.WINFUNCTYPE(ctypes.c_int, ctypes.c_void_p, ctypes.c_int, ctypes.c_int)
	~~#print( 'Add address in python {:#x}'.format(calc.contents.pFunc.contents.Add))~~
	add = add_prototype(calc.contents.pFunc.contents.Add)		add = add_prototype(calc.contents.pFunc.contents.Add)
	print('sum of 2 and 3 is: {}'.format(add(pCalc, 2,3)))		print('sum of 2 and 3 is: {}'.format(add(pCalc, 2,3)))

	</syntaxhighlight>		</syntaxhighlight>

Nachinka: /* Межъязыковая совместимость интерфейсов */

2017-01-31T23:57:08Z

Межъязыковая совместимость интерфейсов

← Предыдущая		Версия 09:57, 1 февраля 2017
Строка 197:		Строка 197:
	end.		end.

			</syntaxhighlight>


			====Язык Python====
			=====Реализация клиента=====
			<syntaxhighlight lang=python>
			import ctypes
			dllname = r'..\build\server.dll'

			class ICalculator_functionlist(ctypes.Structure):
			_fields_ = [('Add', ctypes.c_void_p)]

			class ICalculator(ctypes.Structure):
			_fields_ = [('pFunc', ctypes.POINTER(ICalculator_functionlist))]

			dlllib = ctypes.windll.LoadLibrary(dllname)
			dlllib.GetObject.restype = ctypes.c_void_p
			pCalc = dlllib.GetObject()

			#print( 'Calc address in python {:#x}'.format(pCalc))
			calc = ctypes.cast (pCalc, ctypes.POINTER(ICalculator))
			add_prototype = ctypes.WINFUNCTYPE(ctypes.c_int, ctypes.c_void_p, ctypes.c_int, ctypes.c_int)
			#print( 'Add address in python {:#x}'.format(calc.contents.pFunc.contents.Add))
			add = add_prototype(calc.contents.pFunc.contents.Add)
			print('sum of 2 and 3 is: {}'.format(add(pCalc, 2,3)))

	</syntaxhighlight>		</syntaxhighlight>

Nachinka: /* Язык Free Pascal */

2016-01-24T08:58:06Z

Язык Free Pascal

← Предыдущая		Версия 18:58, 24 января 2016
Строка 144:		Строка 144:

	<syntaxhighlight lang="pascal">		<syntaxhighlight lang="pascal">
			type
			ICalcFuncHandle = ^ICalculatorFunctions;
			ICalculatorHandle = ^ICalculator;

			ICalculatorFunctions = record
			Add: function(pThis: ICalculatorHandle; a, b:integer): integer;stdcall;
			end;

			ICalculator = record
			pFunc:ICalcFuncHandle;
			end;
	</syntaxhighlight>		</syntaxhighlight>

	=====Реализация сервера=====		=====Реализация сервера=====
	<syntaxhighlight lang=pascal>		<syntaxhighlight lang=pascal>
			function Add(pThis: ICalculatorHandle; a,b:integer):integer;stdcall;
			begin
			result:=a+b;
			end;

			function GetObject():ICalculatorHandle;stdcall;
			var Calc:ICalculatorHandle;
			begin
			Calc:=new(ICalculatorHandle);
			Calc^.pFunc^.Add := @Add;
			result:= Calc;
			end;
	</syntaxhighlight>		</syntaxhighlight>

	=====Реализация клиента=====		=====Реализация клиента=====
	<syntaxhighlight lang=pascal>		<syntaxhighlight lang=pascal>
	~~program client;~~
	~~{$mode objfpc}{$H+}~~
	const		const
	{$ifdef win32}		{$ifdef win32}
Строка 167:		Строка 186:
	{$endif}		{$endif}
	{$endif}		{$endif}
	~~type~~
	~~ICalcFuncHandle = ^ICalculatorFunctions;~~
	~~ICalculatorHandle = ^ICalculator;~~

	~~ICalculatorFunctions = record~~
	~~Add: function(pThis: ICalculatorHandle; a, b:integer):integer;stdcall;~~
	~~end;~~

	~~ICalculator = record~~
	~~pFunc:ICalcFuncHandle;~~
	~~end;~~


	function GetObject():ICalculatorHandle; stdcall; external serverlib;		function GetObject():ICalculatorHandle; stdcall; external serverlib;
Строка 188:		Строка 195:
	writeln(pObject^.pFunc^.Add(pObject, 2,3));		writeln(pObject^.pFunc^.Add(pObject, 2,3));
	readln()		readln()
	end.		end.

	</syntaxhighlight>		</syntaxhighlight>

Nachinka: /* Определение интерфейса */

2016-01-24T07:35:58Z

Определение интерфейса

← Предыдущая		Версия 17:35, 24 января 2016
Строка 141:		Строка 141:

	=====Определение интерфейса=====		=====Определение интерфейса=====
	Free Pascal как и С++ - объектно-ориентированный. Но механизм вызова методов объектов отличается. Поэтому приходится взаимодействовать аналогично языку [[C]].		Free Pascal как и С++ - объектно-ориентированный. Но механизм вызова методов объектов отличается. Поэтому приходится взаимодействовать через указатель на список указателей на функции аналогично языку [[Программный_интерфейс#.D0.AF.D0.B7.D1.8B.D0.BA_C\|C]].

	<syntaxhighlight lang="pascal">		<syntaxhighlight lang="pascal">

Nachinka в 07:30, 24 января 2016

2016-01-24T07:30:48Z

@@ Строка 137: / Строка 137: @@
 	return 0;
+}
 </syntaxhighlight>

Андрей Чусов: /* Примеры вызовов на разных языках, отличных от C++ */

2016-01-23T08:05:25Z

Примеры вызовов на разных языках, отличных от C++

← Предыдущая		Версия 18:05, 23 января 2016
Строка 44:		Строка 44:
	</syntaxhighlight>		</syntaxhighlight>

	===~~Примеры вызовов на разных языках, отличных от C++~~===		===Межъязыковая совместимость интерфейсов===

	~~Для интерфейса <tt>IFace</tt>, определенного как~~		====Язык C++====

			=====Определение интерфейса=====
	<syntaxhighlight lang=cpp>		<syntaxhighlight lang=cpp>
	struct ICalculator		struct ICalculator
	{		{
	virtual int __stdcall Add(int A, int B) = 0;		virtual int __stdcall Add(int A, int B) = 0;
	~~//Спецификатор stdcall может отличаться для разных языков и компиляторов одного языка. В MSVC и GCC __stdcall задан.~~
	};		};

			extern "C" void* __stdcall GetObject();
	</syntaxhighlight>		</syntaxhighlight>

	~~Клиент на C.~~		=====Реализация сервера=====

			<syntaxhighlight lang=cpp>
			struct Implementation:ICalculator
			{
			virtual int __stdcall Add(int A, int B);
			};

			int __stdcall Implementation::Add(int A, int B)
			{
			return A + B;
			}

	<syntaxhighlight lang=c>		extern "C" void* __stdcall GetObject()
	/Определение интерфейса ~~на C, в котором~~ нет понятия классов с методами:*/		{
	struct ICalculator; ~~/Объявление/~~		static Implementation instance;
			return &instance;
			}
			</syntaxhighlight>

			=====Реализация клиента=====
			<syntaxhighlight lang=cpp>
			#include <iostream>

			int main(int, char**)
			{
			ICalculator* pObject = (ICalculator*) GetObject();
			std::cout << "Summ of 2 and 3 is " << pObject->Add(2, 3) << ".\n";
			return 0;
			}
			</syntaxhighlight>

			====Язык C====

			=====Определение интерфейса=====

			В языке нет понятия классов с методами, поэтому интерфейс определяется как структура с указателем на список указателей на функции-реализации методов интерфейса. Указатель на объект класса, над которым вызывается метод, передается в каждую функцию-метод как первый параметр. В архитектуре x86 и языке C++ этот параметр обычно передается через регистр <tt>ecx</tt> (см. [https://en.wikipedia.org/wiki/X86_calling_conventions#thiscall thiscall]), поэтому методы реализуются согласно спецификации stdcall, требующей передачу всех параметров через стек. Для x64 данное требование не применимо, так как в этом случае для функций и методов используется единая (для платформы) [https://en.wikipedia.org/wiki/X86_calling_conventions#x86-64_calling_conventions конвенция вызовов].

			<syntaxhighlight lang="c">
			struct ICalculator;

	struct ICalculator_functionlist		struct ICalculator_functionlist
	{		{
	int (__stdcall * Add)(struct ~~IFace~~* pThis, int A, int B);		int (__stdcall * Add)(struct ICalculator* pThis, int A, int B);
	};		};

Строка 72:		Строка 109:
	};		};

	int main(int argc, char** argv);		void* __stdcall GetObject();
			</syntaxhighlight>

			=====Реализация сервера=====
			<syntaxhighlight lang=c>
			int __stdcall Add(struct ICalculator* pThis, int A, int B)
			{
			return A + B;
			}

			void* __stdcall GetObject()
			{
			static struct ICalculator_functionlist vtbl = {Add};
			static struct ICalculator impl = {{&vtbl}};
			return &impl;
			}
			</syntaxhighlight>

			=====Реализация клиента=====
			<syntaxhighlight lang=c>
			#include <stdio.h>

			int main(int argc, char** argv)
	{		{
	~~/Получение экземпляра через точку входа/~~		struct ICalculator* pInst = GetObject();
	struct ICalculator* pInst = ~~(struct ICalculator)~~ GetObject(~~/аргументы*/~~);		printf("Summ of 2 and 3 is %d.\n", pInst->pFunc->Add(pInst, 2, 3));
	~~/Вызов/~~		return 0;
	printf("%d", pInst->pFunc(pInst, 1, 2));
	return 0;
	}		}
	</syntaxhighlight>		</syntaxhighlight>

Андрей Чусов: Новая страница: «Под программным интерфейсом, если не оговорено иное, понимаетс…»

2015-12-28T08:12:04Z

Новая страница: «Под программным интерфейсом, если не оговорено иное, понимаетс…»

Новая страница

Под [[программный интерфейс|программным интерфейсом]], если не оговорено иное, понимается набор число виртуальных функций, вызываемых над скрытым указателем на объект, либо согласно спецификации [https://ru.wikipedia.org/wiki/%D0%A1%D0%BE%D0%B3%D0%BB%D0%B0%D1%88%D0%B5%D0%BD%D0%B8%D0%B5_%D0%BE_%D0%B2%D1%8B%D0%B7%D0%BE%D0%B2%D0%B5 thiscall], либо (для обеспечения межъязыковой совместимости) [https://ru.wikipedia.org/wiki/%D0%A1%D0%BE%D0%B3%D0%BB%D0%B0%D1%88%D0%B5%D0%BD%D0%B8%D0%B5_%D0%BE_%D0%B2%D1%8B%D0%B7%D0%BE%D0%B2%D0%B5 stdcall] с первым скрытым параметром - указателем на объект.

Пусть интерфейс определен как

<syntaxhighlight lang=cpp>
struct IFace
{
virtual void Method() = 0;
};
</syntaxhighlight>

Такой интерфейс связан с объектом, обычно получаемым через компонент фабрику-класса

<syntaxhighlight lang=cpp>
IClassFactory$ refFactory = get(); //Экземпляр порождающего класса, полученный откуда-то
IFace& inst = refFactory->CreateInstance(/*Аргументы*/);
</syntaxhighlight>

либо через точку входа, имеющую связывание в стиле C
<syntaxhighlight lang=cpp>
/*Импортируемая откуда-то функция, связывание C*/
extern "C" void* /*dllimport*/ GetObject(/*параметры*/);

struct IFace
{
virtual void Method() = 0;
};

int main(int argc, char** argv)
{
IFace* object_ptr = (struct IFace*) GetObject(/*аргументы*/);
object_ptr->Method();
return 0;
}
</syntaxhighlight>

либо предоставляется как параметр какой-либо функции

<syntaxhighlight lang=cpp>
void caller(IFace* object_ptr)
{
object_ptr->Method();
}
</syntaxhighlight>

===Примеры вызовов на разных языках, отличных от C++===

Для интерфейса <tt>IFace</tt>, определенного как

<syntaxhighlight lang=cpp>
struct ICalculator
{
virtual int __stdcall Add(int A, int B) = 0;
//Спецификатор stdcall может отличаться для разных языков и компиляторов одного языка. В MSVC и GCC __stdcall задан.
};
</syntaxhighlight>

Клиент на C.

<syntaxhighlight lang=c>
/*Определение интерфейса на C, в котором нет понятия классов с методами:**/
struct ICalculator; /*Объявление*/

struct ICalculator_functionlist
{
int (__stdcall * Add)(struct IFace* pThis, int A, int B);
};

struct ICalculator
{
struct ICalculator_functionlist* pFunc;
};

int main(int argc, char** argv);
{
/*Получение экземпляра через точку входа*/
struct ICalculator* pInst = (struct ICalculator*) GetObject(/*аргументы*/);
/*Вызов*/
printf("%d", pInst->pFunc(pInst, 1, 2));
return 0;
}
</syntaxhighlight>